Skip to main content
POST
https://apis.hopnow.io
/
v1
/
customers
/
{customer_id}
/
accounts
Create Account
curl --request POST \
  --url https://apis.hopnow.io/v1/customers/{customer_id}/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>"
}
'
{
  "id": "<string>",
  "object": "<string>",
  "customer_id": "<string>",
  "name": "<string>",
  "status": "<string>",
  "balances": [
    {}
  ],
  "created": "<string>",
  "updated": "<string>"
}

Path Parameters

customer_id
string
required
The customer’s external ID (starts with cus_)

Request Body

name
string
required
A descriptive name for the account (max 255 characters)

Response

id
string
Unique account identifier (starts with acc_)
object
string
Always returns "account"
customer_id
string
The customer’s external ID
name
string
The account name
status
string
Account status: active, suspended, or inactive
balances
array
Array of account balances by currency (empty for new accounts)
created
string
ISO 8601 timestamp when the account was created
updated
string
ISO 8601 timestamp when the account was last updated

Response Example

{
  "id": "acc_1234567890abcdef",
  "object": "account",
  "customer_id": "cus_abc123",
  "name": "Primary Trading Account",
  "status": "active",
  "balances": [],
  "created": "2024-01-01T00:00:00Z",
  "updated": "2024-01-01T00:00:00Z"
}