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"
}