Skip to main content
POST
/
v1
/
accounts
Create account
curl --request POST \
  --url https://api.example.com/v1/accounts \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "partyId": "019bdb2a-960f-789d-8955-21720e6cdeee"
}
'
{
  "correlationId": "550e8400-e29b-41d4-a716-446655440000"
}

Headers

​
Idempotency-Key
string
required

Client-provided idempotency key. UUID v4 suggested, max 255 characters.

Maximum string length: 255
Pattern: \S

Body

application/json

Request to create an account for a party

​
partyId
string<uuid>
required

Party ID to associate the account with

Pattern: [a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}
Example:

"019bdb2a-960f-789d-8955-21720e6cdeee"

Response

Account creation request accepted

Response for accepted asynchronous requests

​
correlationId
string

Correlation identifier for tracking the request through events

Example:

"550e8400-e29b-41d4-a716-446655440000"

Last modified on January 27, 2026