Marketing Messages on Messenger

Marketing Message API for Messenger Changelog

Jan 6, 2026

POST /act_<AD_ACCOUNT_ID>/messages

Personalized Greetings for Freeform Messages

  • Freeform templates now support adding a greeting which shows up as a separate message before the marketing message.
  • Businesses can use this greeting to create a more engaging conversational experience, as well as make use of the {{first_name}}, {{last_name}}, and {{full_name}} macros.
  • For implementation details please see the documentation.

Nov 20, 2025

POST /act_<AD_ACCOUNT_ID>/messages

Introducing Quick Replies

  • We are excited to introduce Quick Replies for the Marketing Message API for Messenger.
  • Quick replies let you display up to 13 customizable buttons in a Messenger conversation, each with a title and optional image, shown above the message composer.
  • They can be used to prompt users for specific actions or information, including text responses, phone number, or email address.
  • When a user taps a quick reply, the buttons disappear and the selected response is sent to your webhook along with any associated payload.

Webhooks for Message Deliveries and Clicks

  • The Marketing Message API for Messenger now supports webhooks for message delivery and click events.
  • The new message delivery webhook notifies your application when a marketing message is successfully delivered to at least one user’s Messenger client.
  • The click webhook sends a notification when a user clicks on a marketing message, enabling real-time tracking of user engagement.

Disable Usage of Postback Buttons With Video Attachment

  • Postback buttons cannot be used with video attachments due to restrictions with the template.

Nov 7, 2025

POST /act_<AD_ACCOUNT_ID>/customaudiences

Facebook Page in Custom Audience API

  • You can now access the messenger_marketing_messages_page field in the Custom Audiences API for Marketing Messages custom audiences.
  • Returning the associated Facebook Page in the Custom Audience API helps ensure you use the correct Page Access Token when making queries with the Subscription Tokens API.

POST /<PAGE>/notification_message_tokens

Parameter to Remove Duplicate Recipients in Subscription Tokens API

  • You can now obtain a single token per recipient by using the do_not_return_duplicates parameter in the Subscription Tokens API.
  • In the Recurring Notifications API, recipients may have multiple tokens if they subscribe to different Topics. This filter helps prevent sending multiple Marketing Messages to the same recipient.

Nov 6, 2025

POST /act_<AD_ACCOUNT_ID>/messages

Introducing Coupon Codes and LTO Format

  • We are excited to announce the launch of the coupon codes and limited time offers (LTO) message formats.
  • You can now send marketing messages that feature a coupon, with the option to include an expiration time and display a running timer.
  • For additional details please see the documentation.

Nov 3, 2025

POST /act_<AD_ACCOUNT_ID>/messages

Introducing the Image Grid Format

  • With the addition of this new format you can now showcase several images in a grid pattern within your marketing message.
  • To do so, include the image_urls parameter in your message payload and specify the images you would like to display.
  • For more details please visit the documentation.

Oct 20, 2025

POST /act_<AD_ACCOUNT_ID>/messages

Improved Reliability for Message Sending

  • Improved the reliability of sending direct marketing messages using the Marketing Message API for Messenger.
  • Implemented more descriptive and explicit error messages to improve troubleshooting and transparency.

Webhooks for Message Sending

  • We are excited to announce the launch of the message send status webhook feature.
  • After a page sends a marketing message, your application can now receive a webhook notification confirming the message has been sent.
  • For setup and additional details please visit the documentation.

Remove Per-Campaign Send Restriction

  • Previously, campaigns were limited to sending only one marketing message to a subscriber within a 90-day period.
  • This restriction has now been lifted, allowing the same campaign to send multiple messages to the same subscriber in a 90-day window.

Oct 6, 2025

POST act_<AD_ACCOUNT_ID>/campaigns

CTM Ads Is Now Available to All Users

  • Click-to-Messenger (CTM) Ads supply has successfully completed its experimentation phase and is now available to all users using Marketing Messages on Messenger.
  • With this launch, businesses can expect a higher rate of subscriber growth through the opt-in flow.

POST /act_<AD_ACCOUNT_ID>/messages

Postback Suport

  • We have enabled postback support for Marketing Messages ensuring that a user's action on a marketing message button will be sent back to the message thread.
  • To enable postback, clients can setup a webhook and add it onto their app and when the button is clicked an event will be sent to that webhook

Sept 26, 2025

POST /act_<AD_ACCOUNT_ID>/messages

Add personalization macros

  • Enable personalization macros to the title and subtitle fields for all formats. {{first_name}}, {{last_name}}, and {{full_name}} can be added into the title and subtitle strings to enable personalized marketing messages. For carousel, each element can have a personalized title and subtitle. Buttons do not have personalization enabled.

Sept 8, 2025

POST /act_<AD_ACCOUNT_ID>/customaudiences

Upload Status Webhook for Custom Audience API

  • When uploading a list of subscribers using the Custom Audience API, we now support a webhook that triggers when the subscriber upload and matching process is complete.
  • This can be used to keep track of when a created custom audience is ready to use.

GET /<PAGE_ID>/notification_message_tokens

Increase Limit for Fetching Subscriber Tokens

  • Increase the page limit from 100 to 1000.
  • Increase the endpoint request limit from 200 per hour per DAU to 1000 per hour per DAU.
  • As a result of these changes, the maximum number of subscriber tokens that can be fetched within a period of 1 hour from 20,000 per DAU to 1,000,000 per DAU.

Fix Missing Subscriber Tokens With Filters

  • Previously, filtering subscription tokens by custom audience IDs did not return any tokens due to restrictive filtering logic.
  • Using custom audience ID filters will now correctly return all matching tokens.

POST /act_<AD_ACCOUNT_ID>/messages

Fix Missing Marketing Message From Page's Inbox

  • Due to privacy reasons, marketing messages sent to custom audiencce subscrbers were not be visible to the page after delivery.
  • Once the user responds to these messages, these messages will now become visible to the page.

Aug 25, 2025

POST /act_<AD_ACCOUNT_ID>/messages

Allow the Creation of Marketing Messages Without a Button

  • When sending a marketing message, it is no longer necessary for the message payload attachment to include a button.

Improved Message Sending for Custom Audience Subscribers

  • Increase the proportion of custom audience subscribers which are eligible to receive a marketing message by 10%.

POST /act_<AD_ACCOUNT_ID>/message_campaign

Check Terms of Service During Campaign Creation

  • Return an error response during campaign creation when the business has not signed the Marketing Message API for Messenger Terms of Service.

Aug 11, 2025

POST /act_<AD_ACCOUNT_ID>/messages

Cooldown Between Message Sends

  • The subscription_token message sending cooldown has been updated from 24 hours to 12 hours. This means marketing messages sent using the same subscription_token now require only a 12-hour wait between sends, allowing for more frequent communication with users.

July 31, 2025

POST /<CUSTOM_AUDIENCE_ID>/users

GET /<PAGE_ID>/notification_message_tokens

Custom Audience Segmentation For Subscription Tokens

  • When uploading a list of subscribers via /<CUSTOM_AUDIENCE_ID>/users in the Custom Audience API, the corresponding Custom Audience ID(s) will be included in the subscription token’s custom_audience_ids field. Note that a single subscription token can be associated with multiple custom audience uploads.
  • You can filter subscription tokens by one or more Custom Audience IDs using the optional custom_audience_ids query parameter on the /<PAGE_ID>/notification_message_tokens endpoint.
  • To safeguard user privacy, the /<PAGE_ID>/notification_message_tokens endpoint will only return subscription tokens for a given Custom Audience if there are 100 or more matched users in that audience upload. If fewer than 100 users match, tokens for that Custom Audience will be excluded from the response.

GET act_<AD_ACCOUNT_ID>/insights

Measure a Marketing Messages on Messenger Campaign Performance

  • Insights under an ad account can be obtained by the act_<AD_ACCOUNT_ID>/insights endpoint

July 1, 2025

Introducing the Marketing Message API for Messenger!