Create Customer
curl --request POST \
--url https://app.thinnest.ai/api/v1/customers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Sunrise Dental Clinic",
"externalId": "clinic-0042",
"metadata": {
"city": "Pune",
"tier": "gold",
"seats": 3
},
"timezone": "Asia/Kolkata"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Sunrise Dental Clinic',
externalId: 'clinic-0042',
metadata: {city: 'Pune', tier: 'gold', seats: 3},
timezone: 'Asia/Kolkata'
})
};
fetch('https://app.thinnest.ai/api/v1/customers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/customers"
payload = {
"name": "Sunrise Dental Clinic",
"externalId": "clinic-0042",
"metadata": {
"city": "Pune",
"tier": "gold",
"seats": 3
},
"timezone": "Asia/Kolkata"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "org_5b2f9c1e-8a4d-4f7b-9e3a-2c6d1f0a7b84",
"name": "Sunrise Dental Clinic",
"externalId": "clinic-0042",
"metadata": {
"city": "Pune",
"tier": "gold",
"seats": 3
},
"timezone": "Asia/Kolkata",
"allottedCallLines": null,
"archivedAt": null,
"eraseAfter": null,
"createdAt": "2026-10-06T09:30:12.881Z"
}Customers
Create Customer
Creates a workspace for one of your customers and answers with its id — send that id as Thinnest-Workspace to act inside it. Your first customer makes your workspace a developer workspace; everything a customer uses (calls, messages, replies, number rental) is charged to your balance at your plan’s prices, and your plan caps how many customers you may have (3 on Free and pay-as-you-go, 100 on Pro, 1,000 on Scale, 10,000 on Enterprise; a deleted customer counts until it is erased). Send an Idempotency-Key so a retry never makes a second workspace. Needs a full key.
POST
/
customers
Create Customer
curl --request POST \
--url https://app.thinnest.ai/api/v1/customers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Sunrise Dental Clinic",
"externalId": "clinic-0042",
"metadata": {
"city": "Pune",
"tier": "gold",
"seats": 3
},
"timezone": "Asia/Kolkata"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Sunrise Dental Clinic',
externalId: 'clinic-0042',
metadata: {city: 'Pune', tier: 'gold', seats: 3},
timezone: 'Asia/Kolkata'
})
};
fetch('https://app.thinnest.ai/api/v1/customers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/customers"
payload = {
"name": "Sunrise Dental Clinic",
"externalId": "clinic-0042",
"metadata": {
"city": "Pune",
"tier": "gold",
"seats": 3
},
"timezone": "Asia/Kolkata"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "org_5b2f9c1e-8a4d-4f7b-9e3a-2c6d1f0a7b84",
"name": "Sunrise Dental Clinic",
"externalId": "clinic-0042",
"metadata": {
"city": "Pune",
"tier": "gold",
"seats": 3
},
"timezone": "Asia/Kolkata",
"allottedCallLines": null,
"archivedAt": null,
"eraseAfter": null,
"createdAt": "2026-10-06T09:30:12.881Z"
}Authorizations
Headers
Body
application/json
Response
The customer was created.
A workspace you created for one of your customers.