Create an account under a specific customer
Use the POST {URI}/customers/{customerIdentifier}/accounts
endpoint to create an account under a specific customer on this platform.
Endpoint | Purpose |
---|---|
POST {URI}/customers/{customerIdentifier}/accounts | Create an account under a specific customer on this platform. |
Here are the list of parameters for when you use POST {URI}/customers/{customerIdentifier}/accounts
to create an account under specific customer on your platform:
Path parameter | Data type | Description |
---|---|---|
customerIdentifier | string | A unique identifier for the customer under which you are creating a new account. The string must have 5-100 characters. |
Body parameter | Data type | Description |
---|---|---|
accountIdentifier | string | A unique identifier for this account. It must be between 5-100 characters and accepts the following: -0-9a-zA-Z in any sequence. |
displayName | string | A friendly name for this account. The string may have up to 100 characters. |
contactEmail | string | An email address for a designated representative for this account. The string may have up to 100 characters. |
currencyCode | string | The only currency accepted by this account for deposits/withdraws is CAD, EUR, GBP, or USD. Only one currency can be specified. Currency can never be changed. The currency defaults to USD if no currency is specified. |
fundingNotification | arrays of object | Send funding notification emails to the address(es). |
- emailAddress | string | (Optional) The email address used to send funding notifications to for this account. |
The following example shows the response for when you use POST {URI}/customers/{customerIdentifier}/accounts
to create an account under specific customer on your platform. The account identifier must be lowercase:
{
"accountIdentifier": "string", (5-100 chars)
"displayName": "string", (100 chars)
"contactEmail": "string", (100 chars)
"currencyCode": "USD", (3 chars)
"fundingNotification": [
{
"emailAddress": "string"
}
]
}
The response message for this endpoint is:
- 201 Created
- 400 Bad request
- 401 Unauthorized
- 403 Forbidden
- 409 Conflict, Duplicate Exist
Updated 3 days ago