POST
/
v1
/
customers
curl -X POST 'https://api.tolt.com/v1/customers' \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
    "email": "cust_123",
    "partner_id": "part_s7mbzRGn46BhVgNFHD6fDgXW",
    "name": "Jim Halpert",
    "subscription_id": "sub_456",
    "customer_id": "jim_halpert_789",
    "click_id": "click_abc",
    "status": "active",
    "active_at": "2025-01-15T14:30:00.000Z"
}'

{
  "success": true,
  "data": [
    {
      "id": "cust_dK9bzRGn46BhVgNFHD6fDgXW",
      "customer_id": "jim_halpert_789",
      "identifier": "james@tolt.com",
      "email": "james@tolt.com",
      "name": "Jim Halpert",
      "status": "active",
      "plan": null,
      "subscription_id": "sub_456",
      "lead_at": "2025-04-25T11:00:00.797Z",
      "active_at": "2025-01-15T14:30:00.000Z",
      "click_id": "click_abc",
      "program_id": "prg_YRsbPDAKhWfdqJbFACheh",
      "partner_id": "part_s7mbzRGn46BhVgNFHD6fDgXW",
      "organization_id": "org_JE3mfYNL9ci7sFaJazAv2",
      "created_at": "2025-04-25T11:00:00.800Z",
      "updated_at": "2025-04-25T11:00:00.800Z",
      "promotion_code_id": null
    }
  ]
}

​
Base URL https://api.tolt.com


​
Body Parameters

​
email*
string

Customer’s email address

​
partner_id*
string

The partner ID who referred this customer

​
name
string - optional

Customer’s name

​
subscription_id
string - optional

Associated subscription identifier

​
customer_id
string - optional

Your internal customer identifier

​
click_id
string - optional

Tracking click identifier

​
created_at
string - optional

ISO 8601 timestamp of when the customer was created

​
lead_at
string - optional

ISO 8601 timestamp of when the customer became a lead

​
active_at
string - optional

ISO 8601 timestamp of when the customer became active

​
status
string - optional

Customer’s status. Valid values are: ‘lead’, ‘trialing’, ‘active’, ‘canceled’

​
Response

​
success
boolean

Whether the request was successful

​
data
array[object]
curl -X POST 'https://api.tolt.com/v1/customers' \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
    "email": "cust_123",
    "partner_id": "part_s7mbzRGn46BhVgNFHD6fDgXW",
    "name": "Jim Halpert",
    "subscription_id": "sub_456",
    "customer_id": "jim_halpert_789",
    "click_id": "click_abc",
    "status": "active",
    "active_at": "2025-01-15T14:30:00.000Z"
}'

{
  "success": true,
  "data": [
    {
      "id": "cust_dK9bzRGn46BhVgNFHD6fDgXW",
      "customer_id": "jim_halpert_789",
      "identifier": "james@tolt.com",
      "email": "james@tolt.com",
      "name": "Jim Halpert",
      "status": "active",
      "plan": null,
      "subscription_id": "sub_456",
      "lead_at": "2025-04-25T11:00:00.797Z",
      "active_at": "2025-01-15T14:30:00.000Z",
      "click_id": "click_abc",
      "program_id": "prg_YRsbPDAKhWfdqJbFACheh",
      "partner_id": "part_s7mbzRGn46BhVgNFHD6fDgXW",
      "organization_id": "org_JE3mfYNL9ci7sFaJazAv2",
      "created_at": "2025-04-25T11:00:00.800Z",
      "updated_at": "2025-04-25T11:00:00.800Z",
      "promotion_code_id": null
    }
  ]
}