Coupon Code Templates
Coupon code templates are marketing templates that display a single copy code button. When tapped, the code is copied to the customer's clipboard.

Limitations
Coupon code templates are currently not supported by the WhatsApp Web Client.
Codes are limited to 15 characters.
Button text cannot be customized.
Templates are limited to one copy code button.
Template Creation
POST
[base-url]/v1/configs/templates
Headers
D360-API-KEY
string
object {WABA Template}
name string optional
namespace string optional
category string optional
components array[object] optional
type string Allowed Values: BODY, HEADER, FOOTER, BUTTONS
format string Allowed Values: TEXT, IMAGE, DOCUMENT, VIDEO
text string optional
example string optional
buttons object optional
type string Allowed Values: PHONE_NUMBER, URL, QUICK_REPLY
text string required
url string optional
phone_number string optional
example string optional
language string optional
rejected_reason string optional
status string optional
Properties
<NAME>
String
Required.
Template name.
Maximum 512 characters.
fall2023_promotion
<EXAMPLE>
String
Required.
Coupon code to be copied when tapped.
Maximum 15 characters.
25OFF
Example Post Body
{
"name": "<NAME>",
"language": "<LANGUAGE>",
"category": "MARKETING",
"components": [
... // Additional components, if using
{
"type":"BUTTONS",
"buttons": [
{
"type":"COPY_CODE",
"example": "<EXAMPLE>"
},
... // Additional buttons, if using
]
}
]
}
Example Request
{
"name": "coupon_code_fall2023_25off",
"language": "en_US",
"category": "MARKETING",
"components": [
{
"type": "HEADER",
"format": "TEXT",
"text": "Our Fall Sale is on!"
},
{
"type": "BODY",
"text": "Shop now through November and use code {{1}} to get {{2}} off of all merchandise!",
"example": {
"body_text": [
[
"25OFF",
"25%"
]
]
}
},
{
"type": "BUTTONS",
"buttons": [
{
"type": "QUICK_REPLY",
"text": "Unsubscribe"
},
{
"type": "COPY_CODE",
"example": "250FF"
}
]
}
]
}
Sending Coupon Templates
POST
https://waba-v2.360dialog.io/messages
It is only possible to send Templates with an Active status. A message template's status can change automatically from Active to Paused or Disabled based on feedback from customers. For this reason, we recommend that you monitor status changes to take appropriate actions whenever a message template that you rely upon becomes, or is in danger of becoming, paused or disabled.
Properties
<TO>
String
Required.
The WhatsApp ID or phone number of the customer to send the message to. See Phone Number Formats.
+16505551234
<NAME>
String
Required.
Name of the template to be sent.
coupon_code_fall2023_25off
<CODE>
String
Required.
The template's language and locale code.
en_US
<INDEX>
Integer
Required.
Indicates order in which button should appear, if the template uses multiple buttons.
Buttons are zero-indexed, so setting value to 0
will cause the button to appear first, and another button with an index of 1
will appear next, etc.
0
<COUPON_CODE>
String
Required.
The coupon code to be copied when the customer taps the button.
25OFF
Post Body Example
{
"messaging_product": "whatsapp",
"to": "<TO>",
"type": "template",
"template": {
"name": "<NAME>",
"language": {
"code": "<CODE>"
},
"components": [
... // Additional components, if using
{
"type": "button",
"sub_type": "COPY_CODE",
"index": <INDEX>,
"parameters": [
{
"type": "coupon_code",
"coupon_code": "<COUPON_CODE>"
}
]
}
]
}
}
Example Request
{
"messaging_product": "whatsapp",
"to": "16505551234",
"type": "template",
"template": {
"name": "coupon_code_fall2023_25off",
"language": {
"code": "en_US"
},
"components": [
{
"type": "body",
"parameters": [
{
"type": "text",
"text": "25OFF"
},
{
"type": "text",
"text": "25%"
}
]
},
{
"type": "button",
"sub_type": "COPY_CODE",
"index": 1,
"parameters": [
{
"type": "coupon_code",
"coupon_code": "25OFF"
}
]
}
]
}
}
Last updated
Was this helpful?