Create Customer

POST

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]

Hide properties

string

Unique identifier for the customer, uuid or prefixed with cust_

string

Your unique identifier for the customer

partner_id

string

ID of the referring partner

name

string

Customer’s name

subscription_id

string

Associated subscription identifier

identifier

string

Customer identifier

customer_id

string

Your internal customer identifier

click_id

string

Tracking click identifier

created_at

string

ISO 8601 timestamp of creation

lead_at

string

ISO 8601 timestamp of lead conversion

active_at

string

ISO 8601 timestamp of activation

updated_at

string

ISO 8601 timestamp of updated customer

status

string

Customer’s current status

plan

string | null

Plan the customer subscribed to

promotion_code_id

string | null

Identifier for a promotoinal code used by the customer

program_id

string

Program ID the customer belongs to

organization_id

string

Organization ID

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
    }
  ]
}

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
    }
  ]
}

POST

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]

Hide properties

string

Unique identifier for the customer, uuid or prefixed with cust_

string

Your unique identifier for the customer

partner_id

string

ID of the referring partner

name

string

Customer’s name

subscription_id

string

Associated subscription identifier

identifier

string

Customer identifier

customer_id

string

Your internal customer identifier

click_id

string

Tracking click identifier

created_at

string

ISO 8601 timestamp of creation

lead_at

string

ISO 8601 timestamp of lead conversion

active_at

string

ISO 8601 timestamp of activation

updated_at

string

ISO 8601 timestamp of updated customer

status

string

Customer’s current status

plan

string | null

Plan the customer subscribed to

promotion_code_id

string | null

Identifier for a promotoinal code used by the customer

program_id

string

Program ID the customer belongs to

organization_id

string

Organization ID

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
    }
  ]
}

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

Response

tolt.js

Guides / How To

Partners

Customers

Clicks

Links

Commissions

Transactions

Promotion Codes

Create Customer

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

Body Parameters

Response

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

​Body Parameters

​Response

tolt.js

Guides / How To

Partners

Customers

Clicks

Links

Commissions

Transactions

Promotion Codes

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

​Body Parameters

​Response

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

Body Parameters

Response

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

Body Parameters

Response