Coupon and LTO Template

Updated: Apr 6, 2026

Copy for LLM

This document describes how to create coupon code format with optional running timer (LTO).

How It Works

A coupon template message has some preset elements and a number of optional properties. The Copy code button is a preset element that cannot be changed. You need to add a coupon code and second button, with default text Shop now, that is configurable with your own text and a URL to redirect a person to your store.

Coupon template card with store image, 2 days left timer, 10% off summer sale title, code 10offsummer, and Copy code button

When a person clicks the Copy code button, the coupon code is copied and the bottom sheet shows up with the confirmation and second button to redirect to your store.

Confirmation bottom sheet reading Promo code copied with paste-at-checkout instructions and a blue Shop now button

Send a Basic Coupon

In the following example, we are sending a basic coupon message that contains a coupon code.

Basic coupon card with green tag icon, 10% off summer sale title, code 10offsummer at checkout, and Copy code button

To send a coupon message, send a POST request to the /PAGE-ID/messages endpoint with a JSON object with the attachment type set to template and payload set with the template_type set to coupon, title set to coupon text, and the coupon_code set to the coupon code to send to the person.

In the following code example we have set title to “10% off summer sale” , subtitle to “Copy code 10offsummer and use at checkout.” , coupon_code to “10offsummer” and coupon_url to “https://www.myshop.com/”.

The subtitle text, Terms may apply., and Reveal code button text are the default text for these coupon message properties.

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID"
  },
  "message":{
    "attachment": {
      "type": "template",
      "payload": {
          "template_type": "coupon",
          "title":"10% off summer sale",
          "subtitle": "Copy code 10offsummer and use at checkout."
          "coupon_code":"10offsummer",
          "coupon_url":"https://www.myshop.com/",
      },
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

On success, your app receives the following JSON response with the PSID for the recipient and the ID for the message:

{
  "recipient_id": "PSID",
  "message_id": "MESSAGE-ID"
}

Send a Complex Coupon

In the following example, we are sending a more complex coupon message that contains image,title, subtitle, shop now button ,coupon code button and greeting params.

In the following code example we have configured a greeting using the coupon_pre_message, title, subtitle, the disclaimer that applies to this coupon, the second button with my store’s URL and “Shop now” text, an image from my store, and additional information to be sent in the webhook notification when a person clicks the Copy code button.

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID"
  },
  "message":{
    "attachment": {
      "type": "template",
      "payload": {
          "template_type": "coupon",
          "title":"10% off summer sale 🎁",
          "subtitle":"Use code 10offsummer at checkout.",
          "coupon_code":"10offsummer",
          "coupon_url":"https://www.myshop.com/",
          "coupon_url_button_title":"Shop now",
          "coupon_pre_message":"We have a new summer sale coming up",
          "image_url": "https://www.myshop.com/sale-image.png",
          "payload":"The coupon for 10% off everything that expires 2022-10-1",
      },
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

Send a Coupon Code With LTO

In the following example, we are sending a coupon code with LTO format by passing expire time in the API params.

In the following code example we have configured LTO format by passing expire_time in the API spec.

When expire_time is passed we show running timer to the user

Series of coupon cards with an LTO countdown timer changing from 2 days left to Last day to Xx hours left as the offer expires

Request example

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID"
  },
  "message":{
    "attachment": {
      "type": "template",
      "payload": {
          "template_type": "coupon",
          "title":"10% off summer sale 🎁",
          "subtitle":"Use code 10offsummer at checkout.",
          "coupon_code":"10offsummer",
          "coupon_url":"https://www.myshop.com/",
          "coupon_url_button_title":"Shop now",
          "expire_time" :"2025-10-25 16:00:00",
          "coupon_pre_message":"We have a new summer sale coming up",
          "image_url": "https://www.myshop.com/sale-image.png",
          "payload":"The coupon for 10% off everything that expires 2022-10-1",
      },
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

Expired Coupon Code

When a coupon code is sent with an expire_time, we display the expired state format once the coupon code has expired.

In the expired state we don’t show coupon code CTA and only show URL CTA (if added) to redirect a person to your store with default title and body.

Reference

Property	Description
`recipient` object	Required. Object containing information about the person receiving the coupon message
`id` string	The Page-scoped ID (PSID) for the person receiving the coupon message
`comment_id` string	Send a Private Reply that contains a coupon template to a person who commented on a post on the Facebook Page
`notification_message_token` string	Send Marketing Messages that contain a coupon template to a person
`post_id` string	Send a Private Reply that contains a coupon template to a person who published a visitor post on the Facebook Page
`user_ref` string	Send a Checkbox plugin that contains a coupon template
`message` object	Required. Contains the attachment object
`attachment` object	Required. Contains the type of message and payload.
`type` enum {`template`}	Required. Message type, set to `coupon`
`payload` object	Required. Contains the message coupon details
`template_type` enum {`coupon`}	Required. Set to `coupon`
`title` string	Required. Title to display in the message. 80 character limit.
`subtitle` string	Subtitle to display in the message. 80 character limit.
`coupon_code` string	Required. Coupon Code for person to copy and apply.
`expire_time` string	optional Expire time to show Limited Time Offer (Timer) to the user.
`coupon_pre_message` string	The message sent before the coupon message
`coupon_url` string	Required. The coupon URL that allows person to redirect to the website to apply the coupon.
`coupon_url_button_title` string	The text for the button that allows a person to click to the coupon URL
`image_url` string	The URL for the image displayed in the coupon message
`payload` string	Additional information to be included in the webhook notification