POST/api/v2/templates

Submit a template

Submit a new WhatsApp Official template for approval.

template uses the same shape as the template builder in the app and is checked with the same rules before it is submitted.

Send an Idempotency-Key header (for example a new UUID per request). A repeat with the same key within 24 hours gets the first answer again, so nothing is sent twice.

Key: kf_live_ / kf_test_… in the Authorization: Bearer header. Created in Settings › API & Webhook › Create key (Pengaturan › API & Webhook › Buat kunci).
Key scope: templates:write
Plan feature: WhatsApp sending API

Body (JSON)

channel_idstringrequired
WhatsApp Official account, waba:<id> from List channels.
templateobjectrequired
Template draft: name, language, category, kind, parameterFormat, body, bodyExamples, and more.

Possible errors

400 invalid_json Body is not valid JSON
400 idempotency_key_invalid Invalid Idempotency-Key
401 missing_key API key not sent
401 key_invalid Unknown API key
401 key_revoked API key revoked
401 key_expired API key expired
401 member_inactive Key creator is no longer a member
403 ip_not_allowed Server IP not in the key's list
403 plan_no_api Plan does not include the API for live keys
403 tenant_blocked Business access suspended
403 scope_missing Key lacks this permission
403 permission_missing Key creator's role lacks this permission
403 channel_not_allowed Channel not allowed for this key
409 idempotency_conflict Idempotency-Key used for different content
409 request_in_progress The same request is still being processed
422 invalid_request Invalid field
429 rate_limited Too many requests per minute
500 internal_error Problem at Klik Flow
502 channel_refused WhatsApp refused the message

Try it

Try it with a test key

Test API keyTest keys only (kf_test_…), kept in this tab only and sent only to this site's API. Body (JSON)Idempotency-Key

/api/v2/templates

Request example

curl -X POST "https://klikflow.id/api/v2/templates" \
  -H "Authorization: Bearer KUNCI_API" \
  -H "Idempotency-Key: 6f1c2a8e-4b1d-4c3a-9e2f-1a2b3c4d5e6f" \
  -H "Content-Type: application/json" \
  -d '{"channel_id":"waba:3","template":{"name":"pengingat_bayar","language":"id","category":"UTILITY","kind":"standard","parameterFormat":"NAMED","header":{"format":"NONE"},"body":"Halo {{nama}}, tagihan {{orderid}} jatuh tempo besok.","bodyExamples":{"nama":"Rina","orderid":"INV-2207"},"footer":"","buttons":[]}}'

Response example 201

{
  "data": {
    "object": "template",
    "name": "pengingat_bayar",
    "language": "id",
    "status": "PENDING",
    "category_changed_to": null
  }
}

Body (JSON)

Possible errors

Try it

Send WhatsApp from your system with the Klik Flow API.