Easy Labs
APIPaymentsCustomer

Create a new customer

Create a new customer

POST
/v1/api/customer/
x-easy-api-key<token>

Merchant API key. Publishable keys (pk_test_* / pk_live_) are safe for browser/frontend use and carry a limited scope set (sessions, payment_instruments, customers, orders writes; products, product_prices, payment_links reads). Secret keys (sk_test_ / sk_live_*) grant full admin access and must only be used server-side.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://loading/v1/api/customer/" \  -H "Content-Type: application/json" \  -d '{    "first_name": "John",    "last_name": "Doe",    "email": "john@example.com",    "phone": "1234567890",    "personal_address": {      "line1": "123 Main St",      "city": "San Francisco",      "region": "CA",      "postal_code": "94105"    },    "tags": {      "customer_type": "premium"    }  }'
{
  "success": true,
  "timestamp": "2026-02-06T12:00:00.000Z",
  "message": "Customer created",
  "data": {
    "id": "IDxxxxxxxxxxxxxxxxxx",
    "entity": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "john@example.com",
      "phone": "1234567890",
      "personal_address": {
        "line1": "123 Main St",
        "city": "San Francisco",
        "region": "CA",
        "postal_code": "94105",
        "country": "USA"
      }
    },
    "tags": {
      "company_id": "comp_abc123"
    }
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}