curl --request POST \
--url https://app.thinnest.ai/api/v1/codes/templates \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "login_code",
"language": "en",
"expiryMinutes": 10,
"securityRecommendation": true,
"button": "copy_code"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'login_code',
language: 'en',
expiryMinutes: 10,
securityRecommendation: true,
button: 'copy_code'
})
};
fetch('https://app.thinnest.ai/api/v1/codes/templates', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/codes/templates"
payload = {
"name": "login_code",
"language": "en",
"expiryMinutes": 10,
"securityRecommendation": True,
"button": "copy_code"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "5e1d8c3b-7a2f-4d96-b4e0-9c6a2f1d8e73",
"name": "login_code",
"language": "en",
"status": "draft",
"reviewNote": null,
"settings": {
"expiryMinutes": 10,
"securityRecommendation": true,
"button": "copy_code",
"apps": []
},
"preview": {
"body": "*123456* is your verification code. For your security, do not share this code.",
"footer": "Expires in 10 minutes."
},
"agent": "ag_2c7e9a14-5b3d-4f8e-a1c6-7d9b0e3f5a21",
"createdAt": "2026-10-06T10:02:17.904Z"
}{
"error": "Meta allows an expiry between 1 and 90 minutes."
}{
"error": "Unauthorized",
"code": "unauthorized"
}{
"error": "One-time codes need a plan with WhatsApp. Pay as you go has no monthly fee."
}{
"error": "Workspace not found.",
"code": "workspace_not_found"
}{
"error": "A template with that name and language already exists."
}{
"error": "This workspace was deleted on 2026-10-06 and is erased on 2026-11-05. POST /v1/customers/{id}/restore brings it back until then.",
"code": "workspace_deleted"
}{
"error": "Over 240 requests a minute. Slow down and retry.",
"code": "rate_limit_resources",
"limit": {
"name": "resources",
"perMinute": 240
}
}Create Code Template
Saves an authentication template as a draft. WhatsApp writes the words; you choose how long the code lasts, whether to add “For your security, do not share this code.”, and the button — copy_code (works everywhere) or one_tap (hands the code to your Android app, which needs apps). Nothing is sent to WhatsApp until Submit Code Template. A build key may do this.
curl --request POST \
--url https://app.thinnest.ai/api/v1/codes/templates \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "login_code",
"language": "en",
"expiryMinutes": 10,
"securityRecommendation": true,
"button": "copy_code"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'login_code',
language: 'en',
expiryMinutes: 10,
securityRecommendation: true,
button: 'copy_code'
})
};
fetch('https://app.thinnest.ai/api/v1/codes/templates', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/codes/templates"
payload = {
"name": "login_code",
"language": "en",
"expiryMinutes": 10,
"securityRecommendation": True,
"button": "copy_code"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "5e1d8c3b-7a2f-4d96-b4e0-9c6a2f1d8e73",
"name": "login_code",
"language": "en",
"status": "draft",
"reviewNote": null,
"settings": {
"expiryMinutes": 10,
"securityRecommendation": true,
"button": "copy_code",
"apps": []
},
"preview": {
"body": "*123456* is your verification code. For your security, do not share this code.",
"footer": "Expires in 10 minutes."
},
"agent": "ag_2c7e9a14-5b3d-4f8e-a1c6-7d9b0e3f5a21",
"createdAt": "2026-10-06T10:02:17.904Z"
}{
"error": "Meta allows an expiry between 1 and 90 minutes."
}{
"error": "Unauthorized",
"code": "unauthorized"
}{
"error": "One-time codes need a plan with WhatsApp. Pay as you go has no monthly fee."
}{
"error": "Workspace not found.",
"code": "workspace_not_found"
}{
"error": "A template with that name and language already exists."
}{
"error": "This workspace was deleted on 2026-10-06 and is erased on 2026-11-05. POST /v1/customers/{id}/restore brings it back until then.",
"code": "workspace_deleted"
}{
"error": "Over 240 requests a minute. Slow down and retry.",
"code": "rate_limit_resources",
"limit": {
"name": "resources",
"perMinute": 240
}
}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 draft.