API Reference · Customers

Create a customer

Creates a new customer record.

POST/v1/customers

Email must be unique per organization + livemode. Creating a customer also provisions a Stripe Customer on your connected account for use with future payments.

Returnscustomer object

Body parameters

emailstringRequired

Customer email. Must be a valid RFC 5322 address.

first_namestringRequired

Given name.

last_namestringRequired

Family name.

phonestring

Optional phone number.

company_namestring

Business name shown on invoices.

notesstring

Free-form internal notes.

metadataobject

Up to 20 arbitrary key/value pairs.

Errors

400

parameter_invalid_email

The `email` field is not a valid email address.

409

resource_already_exists

A customer with that email already exists in the current livemode.

Request

curl https://lunipay.io/api/v1/customers \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "phone": "+18765551234"
  }'

Response

{
  "id": "cus_01JRZK2Q4T9ZS0VCNA3HX7W9EY",
  "object": "customer",
  "livemode": false,
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "phone": "+18765551234",
  "company_name": "Analytical Engines Ltd.",
  "notes": "VIP — priority support",
  "metadata": {
    "internal_id": "ACCT-42"
  },
  "stripe_customer_id": "cus_Pxxxxxxxxxxxx",
  "created": 1713100800,
  "updated": 1713100800
}