Skip to main content
POST
Create a new party
Creates a party. Use partyType: INDIVIDUAL with firstName/lastName, or ORGANISATION with name (and optional vatNumber). The returned id is what you pass when opening an account. Identity verification runs asynchronously after creation — track it on kycStatus (individuals) or kybStatus (organisations); see Account verification.

Authorizations

Body

application/json
partyType
enum<string>
required

Type of party

Available options:
INDIVIDUAL,
ORGANISATION
externalId
string

Optional external reference ID

Maximum string length: 255
firstName
string

Required for INDIVIDUAL parties

Maximum string length: 100
lastName
string

Required for INDIVIDUAL parties

Maximum string length: 100
name
string

Organisation name. Required for ORGANISATION parties

Maximum string length: 255
vatNumber
string

VAT number. ORGANISATION parties only

Maximum string length: 50
address
object

Standardized address format used across all endpoints

Response

Party created

success
boolean

Indicates whether the request was successful

result
object

A party represents an Individual or Organisation that can hold accounts. The partyType field determines which additional fields are present.