Skip to main content
POST
Create Buyer Profile

Headers

x-crossmint-user-id
string

Server-side auth only: the subject to act on behalf of, namespaced under the key's project. Defaults to a fixed service subject when omitted. Ignored for client-side (JWT) auth, where the subject comes from the token.

Authorization
string

Client-side auth only: Bearer <JWT> for the end user (validated against the project's external JWT config).

X-API-KEY
string
required

Project API key. Either a client-side key (paired with Authorization: Bearer <JWT>) or a server-side key.

Body

application/json
shipping
object
required
contact
object
label
string
Required string length: 1 - 120
name
object

Response

The buyer profile was created.

createdAt
string
required
Minimum string length: 1
id
string
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
shipping
object
required
updatedAt
string
required
Minimum string length: 1
contact
object
label
string
Required string length: 1 - 120
name
object