User
Manage user-related functionalities, including social login, password management, account actions, authentication, OTP handling, profile updates, customer management, session management, platform configuration, user group management, and user attribute definition.
Manage customer interactions within the application, including retrieving customer data, getting specific customers via various identifiers such as mobile numbers, emails, user IDs, or usernames, creating new customer with either email or mobile numbers, as configured within the platform, controlling access by blocking or unblocking user with reason provided, archiving and restoring customer data, and updating customer information.
Operations
GET
# Get a List of Users
GET
# Search an Existing Users
POST
# Create User
PUT
# Block/Unblock Users
PUT
# Restore Deleted User
PUT
# Update User Details
PUT
# Archive User
Parameters
company_id
string
Required
Numeric ID allotted to a business account on Fynd Platform.
application_id
string
Required
Alphanumeric ID allotted to an application created within a business account.
q
string
The search query. Mobile number or email ID of a customer.
page_size
integer
The number of items to retrieve in each page. Default value is 10.
Default Value : 10
page_no
integer
The page number to navigate through the given set of results. Default value is 1.
Default Value : 1
Response
200
400
Success. Refer `CustomerListResponseSchema` for more details.
CustomerListResponseSchema
items
array of object (UserSearchSchema)
Array of UserSearchSchema
application_id
string
user_id
string
first_name
string
meta
object
last_name
string
phone_numbers
array of object (PhoneNumber)
Array of PhoneNumber
phone
string
Phone number of the user.
country_code
integer
Country code for mobile number.
active
boolean
Is the phone number active.
primary
boolean
Is it a primary phone number.
verified
boolean
Is the phone number verified.
emails
array of object (Email)
Array of Email
email
string
Email address.
active
boolean
Is the email active.
primary
boolean
Is it a primary email.
verified
boolean
Is the email verified.
gender
string
dob
string
active
boolean
profile_pic_url
string
username
string
account_type
string
Enum
_id
string
created_at
string
| date-time
updated_at
string
| date-time
external_id
string
rr_id
string
archive
boolean
status
string
page
object (PaginationSchema)
PaginationSchema
size
integer
item_total
integer
has_next
boolean
type
string
current
integer
Examples
Parameters
company_id:
"559"
application_id:
"000000000000000000000001"
q:
"{"$or":[{"emails.email":"vinit.mav12@gofynd.com"},{"phoneNumbers.phone":"vinit.mav12@gofynd.com"}]}"
page_size:
1
page_no:
1
Was this section helpful?
GET
Response
Parameters
company_id
string
Required
Numeric ID allotted to a business account on Fynd Platform.
application_id
string
Required
Alphanumeric ID allotted to an application created within a business account.
q
string
The search query. Mobile number or email ID of a customer.
query
array of string
The search queries. Mobile numbers or email IDs of customers.
Response
200
Success. Returns first name, last name, emails, phone number and gender of the user. Refer `UserSearchResponseSchema` for more details.
UserSearchResponseSchema
users
array of object (UserSearchSchema)
Array of UserSearchSchema
application_id
string
user_id
string
first_name
string
meta
object
last_name
string
phone_numbers
array of object (PhoneNumber)
Array of PhoneNumber
phone
string
Phone number of the user.
country_code
integer
Country code for mobile number.
active
boolean
Is the phone number active.
primary
boolean
Is it a primary phone number.
verified
boolean
Is the phone number verified.
emails
array of object (Email)
Array of Email
email
string
Email address.
active
boolean
Is the email active.
primary
boolean
Is it a primary email.
verified
boolean
Is the email verified.
gender
string
dob
string
active
boolean
profile_pic_url
string
username
string
account_type
string
Enum
_id
string
created_at
string
| date-time
updated_at
string
| date-time
external_id
string
rr_id
string
archive
boolean
status
string
Examples
Parameters
company_id:
"559"
application_id:
"000000000000000000000001"
q:
"vinit.mav12@gofynd.com"
query:
"vinit.mav12@gofynd.com"
Was this section helpful?
GET
Response
Parameters
company_id
string
Required
Company ID
application_id
string
Required
Application ID
Request body
phone_number
string
Required
email
string
first_name
string
last_name
string
gender
string
username
string
meta
object
external_id
string
rr_id
string
Response
200
400
User create
CreateUserResponseSchema
user
object (UserSchema)
UserSchema
application_id
string
user_id
string
first_name
string
meta
object
last_name
string
phone_numbers
array of object (PhoneNumber)
Array of PhoneNumber
phone
string
Phone number of the user.
country_code
integer
Country code for mobile number.
active
boolean
Is the phone number active.
primary
boolean
Is it a primary phone number.
verified
boolean
Is the phone number verified.
emails
array of object (Email)
Array of Email
email
string
Email address.
active
boolean
Is the email active.
primary
boolean
Is it a primary email.
verified
boolean
Is the email verified.
gender
string
dob
string
active
boolean
profile_pic_url
string
username
string
account_type
string
Enum
_id
string
created_at
string
| date-time
updated_at
string
| date-time
external_id
string
rr_id
string
Examples
Parameters
company_id:
"559"
application_id:
"000000000000000000000001"
body:
body
Was this section helpful?
POST
Response
Manage user access by blocking or unblocking their accounts, restricting login for blocked accounts and allowing login for unblocked accounts.
Parameters
company_id
string
Required
Company ID
application_id
string
Required
Application ID
Request body
status
boolean
user_id
array of string
reason
string
Response
200
400
Success
BlockUserSuccess
success
boolean
Examples
Parameters
company_id:
"559"
application_id:
"000000000000000000000001"
body:
body
Was this section helpful?
PUT
Response
Parameters
company_id
string
Required
Company ID
application_id
string
Required
Application ID
Request body
user_id
string
reason
string
reason_id
string
Response
200
400
Success
UnDeleteUserSuccess
success
boolean
Examples
Parameters
company_id:
"559"
application_id:
"000000000000000000000001"
body:
body
Was this section helpful?
PUT
Response
Parameters
company_id
string
Required
Company ID
application_id
string
Required
Application ID
user_id
string
Required
User ID
Request body
first_name
string
last_name
string
gender
string
external_id
string
rr_id
string
meta
object
phone_numbers
array of object (UserPhoneNumbers)
Array of UserPhoneNumbers
active
boolean
primary
boolean
verified
boolean
phone
string
country_code
string
emails
array of object (UserEmails)
Array of UserEmails
active
boolean
primary
boolean
verified
boolean
email
string
Response
200
400
User update
CreateUserResponseSchema
user
object (UserSchema)
UserSchema
application_id
string
user_id
string
first_name
string
meta
object
last_name
string
phone_numbers
array of object (PhoneNumber)
Array of PhoneNumber
phone
string
Phone number of the user.
country_code
integer
Country code for mobile number.
active
boolean
Is the phone number active.
primary
boolean
Is it a primary phone number.
verified
boolean
Is the phone number verified.
emails
array of object (Email)
Array of Email
email
string
Email address.
active
boolean
Is the email active.
primary
boolean
Is it a primary email.
verified
boolean
Is the email verified.
gender
string
dob
string
active
boolean
profile_pic_url
string
username
string
account_type
string
Enum
_id
string
created_at
string
| date-time
updated_at
string
| date-time
external_id
string
rr_id
string
Examples
Parameters
company_id:
"559"
application_id:
"000000000000000000000001"
user_id:
"61f02c3dcc701256044ed6c0"
body:
body
Was this section helpful?
PUT
Response
Delete user from sales channel, allowing re-registration with the same mobile/email for a new user account.
Parameters
company_id
string
Required
Company ID
application_id
string
Required
Application ID
Request body
user_id
string
Response
200
400
Success
ArchiveUserSuccess
success
boolean
Examples
Parameters
company_id:
"559"
application_id:
"000000000000000000000001"
body:
body
Was this section helpful?
PUT
Response
Customer attributes enable the tagging of custom values against any customer. This allows the tagging of customer behavior with unique values, which can later be used to categorize customers into specific groups. Before adding any values to customers, definitions for customer attributes must be present. Attributes support multiple data types for defining new attributes for customers.
Operations
POST
# Create a User Attribute Definition
GET
# Get User Attribute Definitions
PUT
# Update User Attribute Definition
DEL
# Delete User Attribute Definition
GET
# Get User Attribute Definition
PUT
# Update Or Create User Attribute
GET
# Get User Attribute
DEL
# Delete User Attribute
GET
# Get All Customer Attributes
GET
# Get User Attribute
Parameters
company_id
string
Required
Numeric ID allotted to a business account on Fynd Platform.
application_id
string
Required
Alphanumeric ID allotted to an application created within a business account.
Request body
name
string
slug
string
description
string
type
string
multi_value
boolean
customer_editable
boolean
encrypted
boolean
pinned
boolean
pin_order
number
default_value
string
validations
array of object
Response
200
400
Success. returns created User Attribute Definition. `UserAttributeDefinitionDetails` for more details.
UserAttributeDefinitionDetails
_id
string
The unique identifier for the attribute definition.
name
string
The attribute name.
slug
string
The attribute key.
description
string
The description of the attribute.
application_id
string
The application ID.
type
string
The attribute type.
Enum
multi_value
boolean
Whether the attribute supports multiple values.
customer_editable
boolean
Whether the attribute is customer-editable.
encrypted
boolean
Whether the attribute is encrypted.
pinned
boolean
Whether the attribute is pinned.
pin_order
integer
The order in which the attribute is pinned.
validations
array of object (UserAttributeDefinitionValidation)
Array of UserAttributeDefinitionValidation
type
string
The type of validation.
Enum
value
Undefined Type
The validation value.
is_locked
boolean
Whether the attribute is locked.
created_by
string
The user who created the attribute.
updated_by
string
The user who last updated the attribute.
created_at
string
| date-time
The creation date of the attribute definition.
modified_at
string
| date-time
The last modification date of the attribute definition.
Examples
Parameters
company_id:
"value"
application_id:
"value"
body:
body
Was this section helpful?
POST
Response
Parameters
excluding_ids
string
Exclude attribute definitions by Ids
slug
string
Filter by attribute slug.
type
string
Filter by attribute type.
customer_editable
boolean
Filter by customer_editable status.
encrypted
boolean
Filter by encrypted status.
pinned
boolean
Filter by pinned status.
pin_order
integer
Filter by pin order.
is_locked
boolean
Filter by locked status.
name
string
Filter by attribute name using a case-insensitive regex.
company_id
string
Required
Numeric ID allotted to a business account on Fynd Platform.
application_id
string
Required
Alphanumeric ID allotted to an application created within a business account.
page_size
integer
The number of items to retrieve in each page. Default value is 10.
Default Value : 10
page_no
integer
The page number to navigate through the given set of results. Default value is 1.
Default Value : 1
Response
200
400
Successful response
Properties
items
array of object (UserAttributeDefinition)
Array of UserAttributeDefinition
_id
string
The unique identifier for the attribute definition.
name
string
The attribute name.
slug
string
The attribute key.
description
string
The description of the attribute.
application_id
string
The application ID.
type
string
The attribute type.
Enum
multi_value
boolean
Whether the attribute supports multiple values.
customer_editable
boolean
Whether the attribute is customer-editable.
encrypted
boolean
Whether the attribute is encrypted.
pinned
boolean
Whether the attribute is pinned.
pin_order
integer
The order in which the attribute is pinned.
validations
array of object
is_locked
boolean
Whether the attribute is locked.
created_at
string
| date-time
The creation date of the attribute.
modified_at
string
| date-time
The modification date of the attribute.
__v
integer
The version number of the attribute.
page
object
Properties
type
string
current
integer
size
integer
item_total
integer
has_next
boolean
Examples
Parameters
excluding_ids:
"value"
slug:
"value"
type:
"value"
customer_editable:
false
encrypted:
false
pinned:
false
pin_order:
1
is_locked:
false
name:
"value"
company_id:
"value"
application_id:
"value"
page_size:
1
page_no:
1
Was this section helpful?
GET
Response
Parameters
attribute_def_id
string
Required
The unique identifier of the attribute definition to update.
application_id
string
Required
Application ID.
company_id
string
Required
Company ID.
Request body
name
string
slug
string
description
string
type
string
multi_value
boolean
customer_editable
boolean
encrypted
boolean
pinned
boolean
pin_order
number
default_value
string
validations
array of object
Response
200
400
Successful update
UserAttributeDefinition
_id
string
The unique identifier for the attribute definition.
name
string
The attribute name.
slug
string
The attribute key.
description
string
The description of the attribute.
application_id
string
The application ID.
type
string
The attribute type.
Enum
multi_value
boolean
Whether the attribute supports multiple values.
customer_editable
boolean
Whether the attribute is customer-editable.
encrypted
boolean
Whether the attribute is encrypted.
pinned
boolean
Whether the attribute is pinned.
pin_order
integer
The order in which the attribute is pinned.
validations
array of object
is_locked
boolean
Whether the attribute is locked.
created_at
string
| date-time
The creation date of the attribute.
modified_at
string
| date-time
The modification date of the attribute.
__v
integer
The version number of the attribute.
Examples
Parameters
attribute_def_id:
"value"
application_id:
"value"
company_id:
"value"
body:
body
Was this section helpful?
PUT
Response
Parameters
attribute_def_id
string
Required
The unique identifier of the attribute definition to delete.
company_id
string
Required
Numeric ID allotted to a business account on Fynd Platform.
application_id
string
Required
Alphanumeric ID allotted to an application created within a business account.
Response
200
400
Successful Deletion
SuccessMessage
success
string
Examples
Parameters
attribute_def_id:
"value"
company_id:
"value"
application_id:
"value"
Was this section helpful?
DEL
Response
Parameters
attribute_def_id
string
Required
The unique identifier of the attribute definition to retrieve.
company_id
string
Required
Numeric ID allotted to a business account on Fynd Platform.
application_id
string
Required
Alphanumeric ID allotted to an application created within a business account.
Response
200
Successful Retrieval
UserAttributeDefinition
_id
string
The unique identifier for the attribute definition.
name
string
The attribute name.
slug
string
The attribute key.
description
string
The description of the attribute.
application_id
string
The application ID.
type
string
The attribute type.
Enum
multi_value
boolean
Whether the attribute supports multiple values.
customer_editable
boolean
Whether the attribute is customer-editable.
encrypted
boolean
Whether the attribute is encrypted.
pinned
boolean
Whether the attribute is pinned.
pin_order
integer
The order in which the attribute is pinned.
validations
array of object
is_locked
boolean
Whether the attribute is locked.
created_at
string
| date-time
The creation date of the attribute.
modified_at
string
| date-time
The modification date of the attribute.
__v
integer
The version number of the attribute.
Examples
Parameters
attribute_def_id:
"value"
company_id:
"value"
application_id:
"value"
Was this section helpful?
GET
Response
Parameters
attribute_def_id
string
Required
The unique identifier of the attribute definition to update.
user_id
string
Required
The unique identifier of the user to update.
application_id
string
Required
Application ID.
company_id
string
Required
Company ID.
Request body
customer_overridden
boolean
attribute
object
Response
200
400
Successful update
UserAttribute
_id
string
The unique identifier for the attribute definition.
name
string
The name of user attribute definition.
user_id
string
The unique identifier for the user.
application_id
string
The application ID.
type
string
The attribute type.
Enum
customer_overridden
boolean
Whether the attribute is customer-editable.
attribute
object
updated_by
string
Examples
Parameters
attribute_def_id:
"value"
user_id:
"value"
application_id:
"value"
company_id:
"value"
body:
body
Was this section helpful?
PUT
Response
Parameters
attribute_def_id
string
Required
The unique identifier of the attribute definition.
user_id
string
Required
The unique identifier of the user.
application_id
string
Required
Application ID.
company_id
string
Required
Company ID.
Response
200
400
Successful update
UserAttribute
_id
string
The unique identifier for the attribute definition.
name
string
The name of user attribute definition.
user_id
string
The unique identifier for the user.
application_id
string
The application ID.
type
string
The attribute type.
Enum
customer_overridden
boolean
Whether the attribute is customer-editable.
attribute
object
updated_by
string
Examples
Parameters
attribute_def_id:
"value"
user_id:
"value"
application_id:
"value"
company_id:
"value"
Was this section helpful?
GET
Response
Parameters
attribute_def_id
string
Required
The unique identifier of the attribute definition.
user_id
string
Required
The unique identifier of the user.
application_id
string
Required
Application ID.
company_id
string
Required
Company ID.
Response
200
400
Successful update
SuccessMessage
success
string
Examples
Parameters
attribute_def_id:
"value"
user_id:
"value"
application_id:
"value"
company_id:
"value"
Was this section helpful?
DEL
Response
Parameters
user_id
string
Required
The unique identifier of the user to update.
application_id
string
Required
Application ID.
company_id
string
Required
Company ID.
page_size
integer
The number of items to retrieve in each page. Default value is 10.
Default Value : 10
page_no
integer
The page number to navigate through the given set of results. Default value is 1.
Default Value : 1
Response
200
400
Successful update
Properties
items
array of object (UserAttribute)
Array of UserAttribute
_id
string
The unique identifier for the attribute definition.
name
string
The name of user attribute definition.
user_id
string
The unique identifier for the user.
application_id
string
The application ID.
type
string
The attribute type.
Enum
customer_overridden
boolean
Whether the attribute is customer-editable.
attribute
object
updated_by
string
page
object
Properties
type
string
current
integer
size
integer
item_total
integer
has_next
boolean
Examples
Parameters
user_id:
"value"
application_id:
"value"
company_id:
"value"
page_size:
1
page_no:
1
Was this section helpful?
GET
Response
Parameters
attribute_id
string
Required
The unique identifier of the attribute to get.
application_id
string
Required
Application ID.
company_id
string
Required
Company ID.
Response
200
400
Successful update
UserAttribute
_id
string
The unique identifier for the attribute definition.
name
string
The name of user attribute definition.
user_id
string
The unique identifier for the user.
application_id
string
The application ID.
type
string
The attribute type.
Enum
customer_overridden
boolean
Whether the attribute is customer-editable.
attribute
object
updated_by
string
Examples
Parameters
attribute_id:
"value"
application_id:
"value"
company_id:
"value"
Was this section helpful?
GET
Response
Customer groups allow the creation of targeted audience segments based on specific attributes or manual inclusion via phone or email. These groups enable the restriction of coupon and promotion usage, as well as the targeting of discounts, to users within the defined groups.
Operations
POST
# Create User Group
GET
# Get User Groups
PUT
# Update User Group
GET
# Get User Group
PATCH
# Modify User Group
Parameters
company_id
string
Required
Numeric ID allotted to a business account on Fynd Platform.
application_id
string
Required
Alphanumeric ID allotted to an application created within a business account.
Request body
conditions
array of object (ConditionsSchema)
Array of ConditionsSchema
user_attribute_definition_id
string
type
string
value
string
type
string
name
string
Required
description
string
Required
file_url
string
Response
201
Success. returns created User Group. `UserGroupResponseSchema` for more details.
UserGroupResponseSchema
conditions
array of object (Conditions)
Array of Conditions
user_attribute_definition_id
string
type
string
value
string
key
string
error
object (UserResponseErrorSchema)
UserResponseErrorSchema
count
integer
file_url
string
name
string
description
string
file_url
string
_id
string
status
string
is_active
boolean
type
string
uid
integer
application_id
string
created_at
string
| date-time
modified_at
string
| date-time
__v
integer
Examples
Parameters
company_id:
"559"
application_id:
"000000000000000000000001"
body:
body
Was this section helpful?
POST
Response
Parameters
company_id
string
Required
Numeric ID allotted to a business account on Fynd Platform.
application_id
string
Required
Alphanumeric ID allotted to an application created within a business account.
page_no
string
page number for pagination result
page_size
string
page size for pagination result
name
string
to search for User Groups which contains given string in their name
type
string
to search for User Groups with given type
Enum
status
string
to get User Groups with given status
group_uid
integer
to get User Groups with given uid
Response
200
Success. User Group details. `UserGroupListResponseSchema` for more details.
UserGroupListResponseSchema
items
array of object (UserGroupResponseSchema)
Array of UserGroupResponseSchema
conditions
array of object (Conditions)
Array of Conditions
user_attribute_definition_id
string
type
string
value
string
key
string
error
object (UserResponseErrorSchema)
UserResponseErrorSchema
count
integer
file_url
string
name
string
description
string
file_url
string
_id
string
status
string
is_active
boolean
type
string
uid
integer
application_id
string
created_at
string
| date-time
modified_at
string
| date-time
__v
integer
page
object (PaginationSchema)
PaginationSchema
size
integer
item_total
integer
has_next
boolean
type
string
current
integer
Examples
Parameters
company_id:
"559"
application_id:
"000000000000000000000001"
page_no:
"1"
page_size:
"10"
type:
"test"
status:
"test"
group_uid:
30
Was this section helpful?
GET
Response
Parameters
company_id
string
Required
Numeric ID allotted to a business account on Fynd Platform.
application_id
string
Required
Alphanumeric ID allotted to an application created within a business account.
group_id
string
Required
Numeric ID allotted to a User Group
Request body
conditions
array of object (ConditionsSchema)
Array of ConditionsSchema
user_attribute_definition_id
string
type
string
value
string
type
string
name
string
description
string
file_url
string
Response
200
404
Success. returns updated User Group. `UserGroupResponseSchema` for more details.
UserGroupResponseSchema
conditions
array of object (Conditions)
Array of Conditions
user_attribute_definition_id
string
type
string
value
string
key
string
error
object (UserResponseErrorSchema)
UserResponseErrorSchema
count
integer
file_url
string
name
string
description
string
file_url
string
_id
string
status
string
is_active
boolean
type
string
uid
integer
application_id
string
created_at
string
| date-time
modified_at
string
| date-time
__v
integer
Examples
Parameters
company_id:
"559"
application_id:
"000000000000000000000004"
group_id:
"6345677535474fbb6944b7ce"
body:
body
Was this section helpful?
PUT
Response
Parameters
company_id
string
Required
Numeric ID allotted to a business account on Fynd Platform.
application_id
string
Required
Alphanumeric ID allotted to an application created within a business account.
group_id
string
Required
Numeric ID allotted to a User Group
Response
200
404
Success. User Group details. `UserGroupResponseSchema` for more details.
UserGroupResponseSchema
conditions
array of object (Conditions)
Array of Conditions
user_attribute_definition_id
string
type
string
value
string
key
string
error
object (UserResponseErrorSchema)
UserResponseErrorSchema
count
integer
file_url
string
name
string
description
string
file_url
string
_id
string
status
string
is_active
boolean
type
string
uid
integer
application_id
string
created_at
string
| date-time
modified_at
string
| date-time
__v
integer
Examples
Parameters
company_id:
"559"
application_id:
"000000000000000000000004"
group_id:
"6345677535474fbb6944b7ce"
Was this section helpful?
GET