API and AuthenticationAdmin APICustomers
Create Customer
Create a customer through the Admin API
Create Customer
Creates a customer in the API key's organization.
Endpoint
POST /customersAuthentication
Requires a valid Admin API key with customer write permission.
Authorization: Bearer your_api_key_hereRequest Body
At least one of firstName, lastName, or displayName is required.
| Field | Type | Required | Description |
|---|---|---|---|
firstName | string | No* | First name |
lastName | string | No* | Last name |
displayName | string | No* | Display name |
emails | array | No | Email entries containing address and isPrimary |
phones | array | No | Phone entries containing number and isPrimary |
customerNumber | string | No | Custom customer number from 5 to 32 characters; generated when omitted |
status | string | No | active (default), inactive, or banned |
source | string | No | Acquisition source; defaults to admin |
profilePhoto | string | No | Profile-photo URL |
*One of firstName, lastName, or displayName must be supplied.
Example Request
curl -X POST "https://api.tiquo.app/api/v1/customers" \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"firstName": "Jane",
"lastName": "Smith",
"emails": [
{ "address": "jane@example.com", "isPrimary": true }
],
"phones": [
{ "number": "+15551234567", "isPrimary": true }
],
"source": "referral"
}'Response
A successful request returns 201 Created and the created customer in data.
Duplicate email addresses or phone numbers return 409 Conflict. Invalid fields return 400 Bad Request.