Customer created

Authorizations

Authorization

string

header

required

The API key to use for authentication

Body

application/json

Customer Schema

Webhook payload for customer.created events

data

object

required

Show child attributes

data.id

string

required

Unique identifier for the customer, prefixed with 'cus_'

Maximum string length: 255

Example:

"cus_GqfKXLmg61LURZhB"

data.object

string

required

Example:

"customer"

data.environment

enum<string>

required

The environment of the customer. Either 'sandbox' or 'production'

Available options:

sandbox,

production

Example:

"sandbox"

data.name

string | null

required

The name of the customer

Minimum string length: 2

Example:

"John Doe"

data.email

string | null

required

The email of the customer

Example:

"[email protected]"

data.phoneNumber

string

required

The phone number of the customer

Example:

"254712345678"

data.description

string | null

required

The description of the customer

Example:

"VIP customer with recurring payments"

data.countryCode

string

required

The country code of the customer

Maximum string length: 2

Example:

"KE"

data.isActive

boolean

required

Whether the customer is active

Example:

true

data.isVerified

boolean

required

Whether the customer is verified

Example:

true

data.lastActiveAt

string | null

required

Timestamp when the customer was last active (ISO 8601 format)

Example:

"2024-12-19T16:45:00.000Z"

data.firstTransactionAt

string | null

required

Timestamp when the customer made their first transaction (ISO 8601 format)

Example:

"2024-12-15T09:15:00.000Z"

data.preferredPaymentMethod

string | null

required

The preferred payment method of the customer

Maximum string length: 50

Example:

"m-pesa"

data.source

enum<string>

required

Source where the customer was created (api, dashboard, checkout, import)

Available options:

api,

dashboard,

checkout

Example:

"api"

data.metadata

object

required

Key-value object allowing you to store additional information.

Key Requirements:

Must be a string
Maximum length of 40 characters

Value Types:

String (maximum 500 characters)
Integer
Floating-point number
Boolean

Limits:

Maximum of 50 key-value pairs

Show child attributes

data.metadata.{key}

Maximum string length: 500

Example:

{
  "user_preference": "dark_mode",
  "last_login": 1640995200,
  "is_premium": true,
  "account_balance": 1250.75,
  "notifications_enabled": false
}

data.createdAt

string

required

Timestamp when the customer was created (ISO 8601 format)

Example:

"2024-12-10T08:30:00.000Z"

data.updatedAt

string

required

Timestamp when the customer was last updated (ISO 8601 format)

Example:

"2024-12-19T14:22:00.000Z"

timestamp

string

required

ISO 8601 timestamp when the event occurred

Example:

"2021-01-01T00:00:00Z"

type

string

default:customer.created

Event type for customer.created

Example:

"customer.created"

object

string

default:event

Object type, always "event"

Example:

"event"

Response

200

Webhook received successfully

Getting Started

APIs

Authorizations

Body

Response