# WhatsApp Cloud API - Marketing Messages Lite API | Developer Documentation

<div id="bkmrk-whatsapp-cloud-api--"><div><div>## WhatsApp Cloud API - Marketing Messages Lite API

<div><div><div><span>Copy for LLM</span></div></div><div>[<span>View as Markdown</span>](/books/meta-whatsapp/page/whatsapp-cloud-api-marketing-messages-lite-api-developer-documentation)</div></div></div><div><div>Version</div></div><div><div><div><div><div><div><span><span>Send marketing template messages with automatic delivery optimization.</span></span></div></div><div><div><span><span>Delivers relevant, timely messages to customers most likely to engage,</span></span></div></div><div><div><span><span>with enhanced deliverability and down-funnel conversion insights.</span></span></div></div></div></div></div></div></div><div><div id="bkmrk-endpoints"><div id="bkmrk-endpoints-1"><div>### Endpoints

</div></div></div><div><table><tbody><tr><td><div>POST</div></td><td><div><span>[/{Version}/{Phone-Number-ID}/marketing\_messages](#bkmrk-post-%2F%7Bversion%7D%2F%7Bpho-1)</span></div></td></tr></tbody></table>

</div><div>---

<div><div><div id="bkmrk-post-%2F%7Bversion%7D%2F%7Bpho"><div id="bkmrk-post-%2F%7Bversion%7D%2F%7Bpho-1"><div>### POST /{Version}/{Phone-Number-ID}/marketing\_messages

</div></div></div><div><div><div><div><div><div><span><span>Send marketing template messages using pre-approved templates. Supports optional product policy controls and message activity sharing settings.</span></span></div></div></div></div></div></div>#### Request Syntax

<div><div><div><div><div><div><span>Try it</span></div></div></div></div></div></div><div><div><div><div><div><div><div>Select language</div></div></div></div>---

</div><div><div><div><div><div><div>Select status code</div></div></div></div>---

</div></div></div></div><div><span>Header Parameters</span>---

<div><div><span>User-Agent</span><span>string</span></div><div><div><div><div><div><div><span><span>The user agent string identifying the client software making the request.</span></span></div></div></div></div></div></div></div><div><div><span>Authorization</span><span>string</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.</span></span></div></div></div></div></div></div></div><div><div><span>Content-Type</span><span>One of "application/json", "application/x-www-form-urlencoded", "multipart/form-data"</span><span>·</span><span>required</span></div></div></div><div><span>Path Parameters</span>---

<div><div><span>Version</span><span>string</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>WhatsApp API version (e.g., v20.0)</span></span></div></div></div></div></div></div></div><div><div><span>Phone-Number-ID</span><span>string</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>WhatsApp Business Phone Number ID</span></span></div></div></div></div></div></div></div></div><div><span>Required</span>---

<div><div><span>Content Type: </span><span>application/json</span></div><div><div><span>Schema: </span><span>MarketingMessageRequestPayload</span></div><div><div><div id="bkmrk-show-child-attribute"><div><span>Show child attributes</span></div></div><div id="bkmrk-marketingmessagerequ"><div>---

<div><span>MarketingMessageRequestPayload</span></div><div>---

<div><div><span>messaging\_product</span><span>"whatsapp"</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Messaging service used. Must be "whatsapp"</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>recipient\_type</span><span>"individual"</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Type of recipient. Must be "individual"</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>to</span><span>string</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>WhatsApp ID or phone number of the message recipient</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>type</span><span>"template"</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Type of message. Must be "template" for marketing messages</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>template</span><span>object</span><span>·</span><span>required</span></div></div><div><div><div id="bkmrk-show-child-attribute-1"><div><span>Show child attributes</span></div></div><div id="bkmrk-namestring%C2%B7requiredn"><div><div>---

<div><div><span>name</span><span>string</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Name of the template.</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>language</span><span>LanguageObject</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Contains a </span></span>`<span><span>language</span></span>`<span><span> object. Specifies the language the template may be rendered in</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>components</span><span>array of TemplateComponent</span></div><div><div><div><div><div><div><span><span>Array of </span></span>`<span><span>components</span></span>`<span><span> objects containing the parameters of the message.</span></span></div></div></div></div></div></div></div><div><div><div id="bkmrk-show-child-attribute-2"><div><span>Show child attributes</span></div></div><div id="bkmrk-components%5B%5Dtemplate"><div><div>---

<div><div><span>components\[\]</span><span>TemplateComponent</span></div></div></div></div></div></div></div></div></div></div></div></div></div><div>---

<div><div><span>product\_policy</span><span>One of "CLOUD\_API\_FALLBACK", "STRICT"</span></div><div><div><div><div><div><div><span><span>Optional product policy setting</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>message\_activity\_sharing</span><span>boolean</span></div><div><div><div><div><div><div><span><span>Optional flag to control message activity sharing</span></span></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div><div><span>Responses</span>---

<div><div><div><div><div><div><span><span>Send marketing template messages using pre-approved templates. Supports optional product policy controls and message activity sharing settings.</span></span></div></div></div></div></div></div><div><span>200</span><div><div><div><div><div><div><span><span>Marketing message sent successfully</span></span></div></div></div></div></div></div><div><div><span>Content Type: </span><span>application/json</span></div><div><div><span>Schema: </span><span>MarketingMessageResponsePayload</span></div><div><div><div id="bkmrk-show-child-attribute-3"><div><span>Show child attributes</span></div></div><div id="bkmrk-marketingmessageresp"><div>---

<div><span>MarketingMessageResponsePayload</span></div><div>---

<div><div><span>contacts</span><span>array of object</span></div></div><div><div><div id="bkmrk-show-child-attribute-4"><div><span>Show child attributes</span></div></div><div id="bkmrk-contacts%5B%5Dobjectshow"><div><div>---

<div><div><span>contacts\[\]</span><span>object</span></div></div><div><div><div id="bkmrk-show-child-attribute-5"><div><span>Show child attributes</span></div></div><div id="bkmrk-inputstringwa_idstri"><div><div>---

<div><div><span>input</span><span>string</span></div></div></div><div>---

<div><div><span>wa\_id</span><span>string</span></div></div></div></div></div></div></div></div></div></div></div></div></div><div>---

<div><div><span>messages</span><span>array of object</span></div></div><div><div><div id="bkmrk-show-child-attribute-6"><div><span>Show child attributes</span></div></div><div id="bkmrk-messages%5B%5Dobjectshow"><div><div>---

<div><div><span>messages\[\]</span><span>object</span></div></div><div><div><div id="bkmrk-show-child-attribute-7"><div><span>Show child attributes</span></div></div><div id="bkmrk-idstringmessage_stat"><div><div>---

<div><div><span>id</span><span>string</span></div></div></div><div>---

<div><div><span>message\_status</span><span>One of "accepted", "held\_for\_quality\_assessment", "paused"</span></div><div><div><div><div><div><div><span><span>The status of a WhatsApp message:</span></span></div></div><div>`<span><span>accepted</span></span>`<span><span>: The message has been accepted by WhatsApp and is being processed</span></span></div><div>`<span><span>held_for_quality_assessment</span></span>`<span><span>: The message is being held for quality assessment before delivery</span></span></div><div>`<span><span>paused</span></span>`<span><span>: The message delivery has been paused</span></span></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div><div>---

<div><div><span>messaging\_product</span><span>string</span></div></div></div></div></div></div></div></div></div></div><div><span>400</span><div><div><div><div><div><div><span><span>Bad Request - Invalid request parameters</span></span></div></div></div></div></div></div><div><div><span>Content Type: </span><span>application/json</span></div></div></div><div><span>401</span><div><div><div><div><div><div><span><span>Unauthorized - Invalid or missing access token</span></span></div></div></div></div></div></div><div><div><span>Content Type: </span><span>application/json</span></div></div></div><div><span>403</span><div><div><div><div><div><div><span><span>Forbidden - Template not approved or insufficient permissions</span></span></div></div></div></div></div></div><div><div><span>Content Type: </span><span>application/json</span></div></div></div></div></div><div><div><div><div><div><div><div>Select language</div></div></div></div>---

</div><div><div><div><div><div><div>Select status code</div></div></div></div>---

</div></div></div></div></div></div></div><div><div id="bkmrk-authentication"><div id="bkmrk-authentication-1"><div>### Authentication

</div></div></div><div><table><tbody><tr><td><div>**Scheme**</div></td><td><div>**Type**</div></td><td><div>**Location**</div></td></tr><tr><td><div><div><div><div><div><div><div><span><span>bearerAuth</span></span></div></div></div></div></div></div></div></td><td><div><div><div><div><div><div><div><span><span>HTTP Bearer</span></span></div></div></div></div></div></div></div></td><td><div><div><div><div><div><div><div><span><span>Header: </span></span>`<span><span>Authorization</span></span>`</div></div></div></div></div></div></div></td></tr></tbody></table>

</div><div>#### Usage Examples

<div><span>bearerAuth:</span><div><div><div><div><div><div><span><span>Include </span></span>`<span><span>Authorization: Bearer your-token-here</span></span>`<span><span> in request headers</span></span></div></div></div></div></div></div></div></div><div>#### Global Authentication Requirements

<div><span>All endpoints require:</span><div><div><div><div><div><div><span><span>bearerAuth</span></span></div></div></div></div></div></div></div></div></div></div>