Skip to main content
POST
Create a new account
Creates an account and its wallet. Link an existing party with partyId, or create one inline with the party object. Self-custody accounts also supply the wallet address — see Venly-managed vs self-custody. A new account starts unverified and can’t move money until it is verified.

Authorizations

Body

application/json

Create a new account. You can either:

  • Reference an existing party by providing partyId
  • Create a new party inline by providing the party object

SELF_CUSTODY companies must also supply the wallet address.

externalId
string
required

Unique external reference for this account

Minimum string length: 1
chain
enum<string>
required

Supported blockchain network

Available options:
AVALANCHE,
BASE,
POLYGON
name
string

Display name for the account

Required string length: 1 - 255
address
string

Wallet address. Required for SELF_CUSTODY companies

partyId
string<uuid>

ID of an existing party to associate as account holder

party
object
Example:
cardProviderReference
object

Response

Account created

success
boolean

Indicates whether the request was successful

result
object