Create a customer

POST

/customers

curl --request POST \
  --url https://api.bizzle.my/v1/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "email": "hello@example.com", "name": "example", "phone": "example", "metadata": {} }'

• Production
• Test (use test keys with the same host; sandbox semantics apply)

Authorizations

• bearerAuth
• xApiKey

Parameters

Header Parameters

Idempotency-Key

string

<= 255 characters

Unique identifier used to replay requests safely.

Request Body

Media typeapplication/json

object

email

string format: email

name

string

phone

string

metadata

object

Example ^generated

{
  "email": "hello@example.com",
  "name": "example",
  "phone": "example",
  "metadata": {}
}

Responses

201

Customer created.

Media typeapplication/json

object

id

string

object

string

Allowed values: customer

merchantId

string

email

string format: email

nullable

name

string

nullable

phone

string

nullable

metadata

object

created

integer format: int64

Example

{
  "id": "cus_5nq1Kdab2pXueN5y8Z",
  "object": "customer"
}

400

Error response.

Media typeapplication/json

object

error

required

string

message

string

code

string

details

object

Example ^generated

{
  "error": "example",
  "message": "example",
  "code": "example",
  "details": {}
}

429

Too many requests.

Media typeapplication/json

object

error

required

string

message

string

code

string

details

object

Example ^generated

{
  "error": "example",
  "message": "example",
  "code": "example",
  "details": {}
}

Headers

RateLimit-Limit

integer

Maximum requests per window.

RateLimit-Remaining

integer

Requests remaining in the current window.

RateLimit-Reset

integer

Unix seconds when the window resets.

Retry-After

integer

Seconds to wait before retrying (on 429/handled outages).