Skip to main content
POST
/
v1
/
partner
/
customers
Create a customer
curl --request POST \
  --url https://api.test.doola.com/v1/partner/customers \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "email": "founder@example.com",
  "firstName": "Ada",
  "lastName": "Lovelace",
  "countryOfResidence": "USA",
  "phoneNumber": "+12125550100"
}
'
{
  "payload": {
    "doolaCustomerId": "<string>",
    "email": "founder@example.com",
    "firstName": "Ada",
    "lastName": "Lovelace",
    "countryOfResidence": "USA",
    "phoneNumber": "+12125550100",
    "created": true,
    "companies": [
      {
        "doolaCompanyId": "<string>",
        "name": "Acme Labs LLC",
        "entityType": "LLC",
        "state": "DE"
      }
    ]
  },
  "error": {}
}

Authorizations

​
Authorization
string
header
required

Partner API key. Send the raw key as the Authorization header value — e.g. dk_test_… in sandbox or dk_live_… in production. Generate and rotate keys in the doola Partner Portal.

Headers

​
Idempotency-Key
string
required

Unique key that makes the create safe to retry. Reuse the same value to retry; if the create fails before committing, the key is released, so retry with the same value.

Body

application/json

Request body to create a customer under your partner tenant.

​
email
string
required

Customer email address.

Example:

"founder@example.com"

​
firstName
string
required

Customer legal first name.

Example:

"Ada"

​
lastName
string
required

Customer legal last name.

Example:

"Lovelace"

​
countryOfResidence
string
required

ISO 3166-1 alpha-3 country of residence (e.g. USA).

Example:

"USA"

​
phoneNumber
string

Customer phone number in E.164 format. Optional.

Example:

"+12125550100"

Response

200 - */*

OK

​
payload
object

A partner customer.

​
error
object