Skip to main content
POST
/
customers
Create a customer
curl --request POST \
  --url https://api.corebill.io/v1/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Jane Smith",
  "country": "US",
  "email": "[email protected]",
  "phone": "+1-555-0200",
  "city": "New York",
  "currency": "USD",
  "legal_name": "Smith Design Inc.",
  "legal_address": "456 Broadway, New York, NY 10013",
  "legal_vat": "US987654321",
  "zipcode": "10013"
}
'
{
  "data": {
    "id": "cus_g7h8i9j0k1l2",
    "name": "Jane Smith",
    "slug": "jane-smith",
    "contact_email": "[email protected]",
    "contact_phone": "+1-555-0200",
    "country": "US",
    "city": "New York",
    "currency": "USD",
    "status": "active",
    "legal_name": "Smith Design Inc.",
    "legal_address": "456 Broadway, New York, NY 10013",
    "legal_vat": "US987654321",
    "zipcode": "10013",
    "created_at": "2025-04-10T16:45:00.000Z"
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Generate keys from the Corebill dashboard under the Developers section.

Example: Authorization: Bearer sk_live_abc123def456

Query Parameters

​
company_id
string
required

The company ID to scope the request to

Body

application/json
​
name
string
required

Customer display name

Example:

"Jane Smith"

​
country
string
required

Country code or name

Example:

"US"

​
email
string<email>

Contact email (stored as contact_email)

Example:

"[email protected]"

​
phone
string

Contact phone (stored as contact_phone)

Example:

"+1-555-0200"

​
city
string

City name

Example:

"New York"

​
currency
string
default:USD

Preferred currency code (ISO 4217). Defaults to USD

Example:

"USD"

​
legal_name
string

Legal business name

Example:

"Smith Design Inc."

​
legal_address
string

Legal business address

Example:

"456 Broadway, New York, NY 10013"

​
legal_vat
string

VAT or tax identification number

Example:

"US987654321"

​
zipcode
string

ZIP or postal code

Example:

"10013"

Response

Customer created successfully

​
data
object
required

Customer object returned in list endpoints