Customers

Create a customer

POST/v1/customers

Creates a customer.

API key · or dashboard session.

Request

Shell
curl -fsS "$API/v1/customers" \
  -H "Authorization: Bearer $PAYDAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Globex", "email": "ap@globex.example", "details": "Attn: Accounts Payable" }'

Response

201 Created
{
  "id": "cus_0198f80c-1111-7dc1-a369-90556a64f700",
  "name": "Globex",
  "email": "ap@globex.example",
  "details": "Attn: Accounts Payable",
  "created_at": "2026-09-06T12:00:00Z",
  "updated_at": "2026-09-06T12:00:00Z"
}

Body

namestringrequired
1–255 bytes.
emailstring
3–254 bytes.
detailsstring
≤4,000 bytes.

Response

Customer.