Customers

Create and retrieve customer profiles for subscription management

Get Customers

Retrieve a list of customers

Query Parameters

Content-Type
string
x-kc-token
string

Response

Successful request, returns customer list

data
array
GET /customers
Response Example
{
  "data": [
    {
      "id": "a3e20b05-4b65-4b15-825f-8c42082e0ab7",
      "status": "published",
      "user_created": "a01c4d98-34e6-48b4-b31d-d543f0cc1da7",
      "date_updated": null,
      "user_updated": null,
      "date_created": "2025-02-28T07:17:34.765Z",
      "first_name": "Stephen",
      "last_name": "Seth",
      "address_line_1": null,
      "address_line_2": null,
      "email": "stephen.seth@mailinator.com",
      "identifier": "unique-saas1",
      "phone": null
    }
  ]
}

Create Customer

Create a new customer profile

Query Parameters

Content-Type
string
x-kc-token
string
x-idempotency-id
string

Request Body

identifier
string
first_name
string
last_name
string
email
string

Response

Customer created successfully

data
object
POST /customers
Response Example
{
  "data": {
    "id": "a3e20b05-4b65-4b15-825f-8c42082e0ab7",
    "status": "published",
    "user_created": "a01c4d98-34e6-48b4-b31d-d543f0cc1da7",
    "date_updated": null,
    "user_updated": null,
    "date_created": "2025-02-28T07:17:34.765Z",
    "first_name": "Stephen",
    "last_name": "Seth",
    "address_line_1": null,
    "address_line_2": null,
    "email": "stephen.seth@mailinator.com",
    "identifier": "unique-saas1",
    "phone": null
  }
}