Skip to main content
POST
/
api
/
v1
/
customers
curl -X POST "https://api-sandbox.paywithsoap.com/api/v1/customers" \
  -H "Authorization:  YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "customer@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "phone_number": "15551234567",
    "date_of_birth": "1990-01-01",
    "internal_id": "3f1b8c4e-7c2e-4c2c-8d2f-179cf0efb36b"
  }'

{
  "id": "cus_A3GuXEbThpqk2t6UTxEuoceVJyUEAX7V",
  "internal_id": "cust_123",
  "email": "customer@example.com",
  "first_name": "John",
  "last_name": "Doe",
  "phone_number": "1234567890",
  "date_of_birth": "1990-01-01",
  "created_at": "2025-03-10T16:08:14.427Z"
}
Creates a new customer with the provided information. The customer can then be used for creating checkouts and other operations. 
curl -X POST "https://api-sandbox.paywithsoap.com/api/v1/customers" \
  -H "Authorization:  YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "customer@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "phone_number": "15551234567",
    "date_of_birth": "1990-01-01",
    "internal_id": "3f1b8c4e-7c2e-4c2c-8d2f-179cf0efb36b"
  }'

{
  "id": "cus_A3GuXEbThpqk2t6UTxEuoceVJyUEAX7V",
  "internal_id": "cust_123",
  "email": "customer@example.com",
  "first_name": "John",
  "last_name": "Doe",
  "phone_number": "1234567890",
  "date_of_birth": "1990-01-01",
  "created_at": "2025-03-10T16:08:14.427Z"
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication using your API key

Body

application/json
​
email
string
required
Example:

"john@player.com"

​
first_name
string
required
Example:

"John"

​
last_name
string
required
Example:

"Doe"

​
phone_number
string

Phone number of the customer in ISO 8601 format (10 digits, no hyphens, no country code)

Example:

"8008001234"

​
date_of_birth
string<date>

Date of birth of the customer in ISO 8601 format (YYYY-MM-DD)

Example:

"1990-01-01"

​
internal_id
string

Internal ID of the customer in your system.

Example:

"3f1b8c4e-7c2e-4c2c-8d2f-179cf0efb36b"

Response

Customer created.

​
id
string

Unique identifier for the customer to be used for future transactions.

Example:

"cus_pQsQ4kz3Af6Mb9rCupnWj6VFzxJsmkYK"

​
internal_id
string
Example:

"3f1b8c4e-7c2e-4c2c-8d2f-179cf0efb36b"

​
email
string
Example:

"john@player.com"

​
first_name
string
Example:

"John"

​
last_name
string
Example:

"Doe"

​
phone_number
string
Example:

"8008001234"

​
date_of_birth
string<date>
Example:

"1990-01-01"

​
created_at
string<date-time>
Example:

"2025-03-05T18:26:43.069Z"