Create a customer

POST /v1/customers

Bearer token

curl 'https://api.sendapropos.com/v1/customers' \
  --request POST \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "display_name": "example",
  "email": "[email protected]",
  "company_name": "example",
  "phone": "example",
  "external_system": "example",
  "external_id": "external_01JXY9AZK4KV"
}'

{
  "data": {
    "id": "123e4567-e89b-42d3-a456-426614174000",
    "displayName": "example",
    "email": "[email protected]",
    "companyName": "example",
    "phone": "example",
    "status": "contact",
    "createdAt": "2026-01-01T12:00:00Z",
    "updatedAt": "2026-01-01T12:00:00Z"
  }
}

Customer created.

Body

· CreateCustomerRequest

required application/json

display_name string · max length: 200 required

email string · email· max length: 320

company_name string · max length: 200

phone string · max length: 50

external_system string · max length: 100

Provide together with external_id to record a mapping for future find-before-create lookups.

external_id string · max length: 200

Body

Responses