curl --request POST \
--url https://app.thinnest.ai/api/v1/forms \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Delivery address",
"category": "CONTACT_US",
"form": {
"title": "Where should we deliver?",
"submitLabel": "Send",
"fields": [
{
"name": "address",
"label": "Full address",
"kind": "paragraph",
"required": true
},
{
"name": "pincode",
"label": "PIN code",
"kind": "number",
"required": true
},
{
"name": "slot",
"label": "Delivery slot",
"kind": "choice",
"options": [
"Morning",
"Evening"
]
},
{
"name": "order",
"label": "Order number",
"kind": "text",
"prefill": true
}
]
}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Delivery address',
category: 'CONTACT_US',
form: {
title: 'Where should we deliver?',
submitLabel: 'Send',
fields: [
{name: 'address', label: 'Full address', kind: 'paragraph', required: true},
{name: 'pincode', label: 'PIN code', kind: 'number', required: true},
{
name: 'slot',
label: 'Delivery slot',
kind: 'choice',
options: ['Morning', 'Evening']
},
{name: 'order', label: 'Order number', kind: 'text', prefill: true}
]
}
})
};
fetch('https://app.thinnest.ai/api/v1/forms', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/forms"
payload = {
"name": "Delivery address",
"category": "CONTACT_US",
"form": {
"title": "Where should we deliver?",
"submitLabel": "Send",
"fields": [
{
"name": "address",
"label": "Full address",
"kind": "paragraph",
"required": True
},
{
"name": "pincode",
"label": "PIN code",
"kind": "number",
"required": True
},
{
"name": "slot",
"label": "Delivery slot",
"kind": "choice",
"options": ["Morning", "Evening"]
},
{
"name": "order",
"label": "Order number",
"kind": "text",
"prefill": True
}
]
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "form_9e2c4a7b-1d5f-4c38-8b6e-0a3f7d2c9e15",
"name": "Delivery address",
"agent": "ag_2c7e9a14-5b3d-4f8e-a1c6-7d9b0e3f5a21",
"category": "CONTACT_US",
"form": {
"title": "Where should we deliver?",
"submitLabel": "Send",
"fields": [
{
"name": "address",
"label": "Full address",
"kind": "paragraph",
"required": true
},
{
"name": "pincode",
"label": "PIN code",
"kind": "number",
"required": true
},
{
"name": "slot",
"label": "Delivery slot",
"kind": "choice",
"required": false,
"options": [
"Morning",
"Evening"
]
},
{
"name": "order",
"label": "Order number",
"kind": "text",
"required": false,
"prefill": true
}
]
},
"published": false,
"publishedAt": null,
"createdAt": "2026-10-06T10:20:51.093Z",
"updatedAt": "2026-10-06T10:20:51.093Z"
}Create Form
Saves a form, unpublished — it cannot be sent until Publish Form succeeds. Up to 8 questions; field names are what each answer comes back under. Without agent, the form goes to the agent holding your WhatsApp number, else your oldest agent. No connected number is needed to build one. A build key may do this.
curl --request POST \
--url https://app.thinnest.ai/api/v1/forms \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Delivery address",
"category": "CONTACT_US",
"form": {
"title": "Where should we deliver?",
"submitLabel": "Send",
"fields": [
{
"name": "address",
"label": "Full address",
"kind": "paragraph",
"required": true
},
{
"name": "pincode",
"label": "PIN code",
"kind": "number",
"required": true
},
{
"name": "slot",
"label": "Delivery slot",
"kind": "choice",
"options": [
"Morning",
"Evening"
]
},
{
"name": "order",
"label": "Order number",
"kind": "text",
"prefill": true
}
]
}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Delivery address',
category: 'CONTACT_US',
form: {
title: 'Where should we deliver?',
submitLabel: 'Send',
fields: [
{name: 'address', label: 'Full address', kind: 'paragraph', required: true},
{name: 'pincode', label: 'PIN code', kind: 'number', required: true},
{
name: 'slot',
label: 'Delivery slot',
kind: 'choice',
options: ['Morning', 'Evening']
},
{name: 'order', label: 'Order number', kind: 'text', prefill: true}
]
}
})
};
fetch('https://app.thinnest.ai/api/v1/forms', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/forms"
payload = {
"name": "Delivery address",
"category": "CONTACT_US",
"form": {
"title": "Where should we deliver?",
"submitLabel": "Send",
"fields": [
{
"name": "address",
"label": "Full address",
"kind": "paragraph",
"required": True
},
{
"name": "pincode",
"label": "PIN code",
"kind": "number",
"required": True
},
{
"name": "slot",
"label": "Delivery slot",
"kind": "choice",
"options": ["Morning", "Evening"]
},
{
"name": "order",
"label": "Order number",
"kind": "text",
"prefill": True
}
]
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "form_9e2c4a7b-1d5f-4c38-8b6e-0a3f7d2c9e15",
"name": "Delivery address",
"agent": "ag_2c7e9a14-5b3d-4f8e-a1c6-7d9b0e3f5a21",
"category": "CONTACT_US",
"form": {
"title": "Where should we deliver?",
"submitLabel": "Send",
"fields": [
{
"name": "address",
"label": "Full address",
"kind": "paragraph",
"required": true
},
{
"name": "pincode",
"label": "PIN code",
"kind": "number",
"required": true
},
{
"name": "slot",
"label": "Delivery slot",
"kind": "choice",
"required": false,
"options": [
"Morning",
"Evening"
]
},
{
"name": "order",
"label": "Order number",
"kind": "text",
"required": false,
"prefill": true
}
]
},
"published": false,
"publishedAt": null,
"createdAt": "2026-10-06T10:20:51.093Z",
"updatedAt": "2026-10-06T10:20:51.093Z"
}Authorizations
Headers
Developers only: the customer workspace this request acts in — its org_… id from POST /customers. Leave it out to act in your own workspace. Refused with 404 (Workspace not found.) when the id is unknown, is not one of your customers, or is not an org_… id; 410 when that customer was deleted (restore it with POST /customers/{id}/restore until it is erased); 403 when the key belongs to one customer workspace (it cannot act as another); 400 when your workspace is not a developer workspace. /customers/* and GET /customers/usage are your own workspace's and refuse the header with 400: call them without it.
"org_3fKq9TzQ1mN8vB2xR7cLpA"
Body
Response
The saved form, not yet published.