Create New

When a customer transacts for the first time, the Create account API call is invoked to create an account for the customer and a unique customer ID is generated for this customer. The parameters of this call are dynamic based on the business setup of the account’s profile.

POST

/accounts/

Request elements

Parameter	Type	Required	Description
first	String	Not mandatory	First name of the customer
last	String	Not mandatory	Last name of the customer
phone	String	Yes	Phone number of the customer
email	String	Yes	Email ID of the customer
gender	String	Not mandatory	Gender of the customer
birthdate	Date	Not mandatory	Date of birth of the customer
nationality	String	Not mandatory	Nationality of the customer

Error messages

Error Code	Error Message
1004	The following field is not unique
1010	At least one of the following fields is required

{
		"phone": "971520000000",
		"email": "john@email.com",
		"first": "John",
		"last": "Samuel",
		"birthdate": "1988-06-06",
		"gender": "M",
		"city": null,
		"country": null,
		"nationality": "India",
		"language": null,
		"businessFields": {
			"maritalStatus": "Married",	
			"residency": "tourist",	
			"ethnicity": "Asian"
		}
}


EXAMPLE RESPONSE:

{
    "status" : "success",
    "account" : {
         "accountId" : "f64f2940-fae4-11e7-8c5f-ef379131"
    }
}