Create Customer

POST

/v1/customers

Creates a new customer contact record in the current workspace.

Parameters

NameTypeDescription
namerequiredstringFull customer name
emailstringCustomer email address
phone_numberstringE.164 formatted phone number

Responses

200Customer created successfully
{
  "data": {
    "id": "cst_102",
    "name": "Bob Smith",
    "email": "bob@corp.com",
    "phone_number": "+15559876543",
    "created_at": "2026-09-02T14:00:00Z"
  }
}
422Validation error
{
  "errors": [
    {
      "field": "email",
      "message": "is invalid"
    }
  ]
}