post
https://partner.gupshup.io/partner/app//templates
Creates the template on the given app and submits it to Meta for approval
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Rate limit:
10 requests per 60 seconds.
Note:
Templates that carry a REQUEST_CONTACT_INFO button can only be of the marketing or utility category.
Button constraints
- Only one button is allowed — it cannot be combined with URL, QUICK_REPLY, or any other button type.
- Button text is fixed per language and cannot be customised; Meta enforces a localised string per language code.
- Do not include parameter values when sending the template — the button text is not a variable.
Localised button text by language
The button text is auto-localised by Meta based on the template language code. The en string differs from en_GB (lowercase), so always send the value Meta expects for the chosen locale.
| Language code | Required button text | Status |
|---|---|---|
en | Share Contact Info | Works |
en_US | Share Contact Info | Works |
en_GB | Share contact info (lowercase c, i) | Works |
hi | कॉन्टैक्ट जानकारी शेयर करें | Works |
es | Compartir información de contacto | Works |
Sample Request (Marketing):
curl --location 'https://qa-partner-api.smsgupshup.dev/partner/app/{{APP_ID}}/templates' \
--header 'Authorization: {{PARTNER_APP_TOKEN}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'elementName=safari_req_contact_info_mm' \
--data-urlencode 'languageCode=en' \
--data-urlencode 'content=Hello! We have an update regarding your transaction. Could you please share your contact details?' \
--data-urlencode 'category=MARKETING' \
--data-urlencode 'vertical=AAA' \
--data-urlencode 'templateType=TEXT' \
--data-urlencode 'example=Hello! We have an update regarding your transaction. Could you please share your contact details?' \
--data-urlencode 'allowTemplateCategoryChange=false' \
--data-urlencode 'checkerApprovalRequired=false' \
--data-urlencode 'enableSample=false' \
--data-urlencode 'buttons=[{"type":"REQUEST_CONTACT_INFO","text":"Share Contact Info"}]'Sample Request (Utility):
curl --location 'https://qa-partner-api.smsgupshup.dev/partner/app/{{APP_ID}}/templates' \
--header 'Authorization: {{PARTNER_APP_TOKEN}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'elementName=safari_req_contact_info_ut' \
--data-urlencode 'languageCode=en' \
--data-urlencode 'content=Your order {{1}} is out for delivery. Please share your contact so the courier can reach you.' \
--data-urlencode 'category=UTILITY' \
--data-urlencode 'vertical=AAA' \
--data-urlencode 'templateType=TEXT' \
--data-urlencode 'example=Your order [A-10293] is out for delivery. Please share your contact so the courier can reach you.' \
--data-urlencode 'allowTemplateCategoryChange=false' \
--data-urlencode 'enableSample=true' \
--data-urlencode 'buttons=[{"type":"REQUEST_CONTACT_INFO","text":"Share Contact Info"}]'