In Developers > Credentials, create a token for the messages:write integration. Copy it during creation, store it in your backend, and configure the WhatsApp connection in the dashboard before sending.
API Developer
API to connect WhatsApp to your systems and applications.
Integrate CRM, ERP, apps and internal systems with WhatsApp using the WPP Marketing REST API. Send text and media, query messages and track deliveries via webhooks. Also use MCP to integrate your flows with the Official API. Learn about MCP.
When to use
Use the messaging API when your system needs to send WhatsApp messages.
Use your CRM to start a contact, your ERP to send an update, or your app to notify a customer. The logic for when to send stays in your system; the API performs the sending through the connection configured on the account. For ready-made commercial automations, use the Events API.
Use POST /send-text for text or POST /send-media for media. On the official connection, text and image use the configured templates; audio, video and documents require a message received from the customer within the last 24 hours.
HTTP 200 indicates acceptance, not delivery. With messages:read, use GET /messages and check the available statuses for the channel.
Register the HTTPS URL and enable events in the dashboard. Use webhooks:read to query attempts at GET /webhooks; this endpoint lists deliveries, it does not register subscriptions.
From the token to the first shipment included.
On your server, replace SEU_TOKEN with the credential and the number with the authorized recipient for the test. Use a unique key per send and reuse the same key only when repeating the same request.
Check the HTTP status and response body. For 401, review the token and its validity; for 403, verify scopes and account conditions. For 409, check if the key has already been used with other content. For 429, respect Retry-After before retrying.
Then check GET /messages with messages:read or monitor the configured webhooks. Delivery confirmation depends on the channel's response.
cURLPOST /send-text
curl --request POST 'https://api.wppmarketing.com/send-text' \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: pedido-10231-aviso-1' \
--data '{"number":"5511999999999","body":"Olá! Seu pedido foi atualizado."}'Text, media, history and tracking of messages.
Use the REST endpoints to integrate WhatsApp with your application. The WPP Marketing API uses the connection configured in the account; to work with the Official WhatsApp API, configure that connection in the dashboard. See the OpenAPI for the formats, scopes, limits and responses of each operation.
POST
/send-text
Sends a text message to a WhatsApp number.
Texto
POST
/send-media
Send image, audio, video, or document via a public HTTPS URL, according to the format and connection conditions. Audio uses this same endpoint.
Mídia
GET
/messages
Check the history of sent messages with status and pagination.
Histórico
GET
/webhooks
Check webhook deliveries with event, HTTP result, attempts and pagination.
Webhooks
DOC
Swagger / OpenAPI
Interactive documentation with contracts, examples, required fields, and expected responses.
Docs
Technical separation
Choose the right feature for each stage of the integration.
Send messages with the Messaging API, trigger business automations with the Events API, and receive callbacks via webhooks. Your application can combine these features as needed for the required flow.
The official connection is the communication channel; the WPP Marketing API is the interface used by your system. See the requirements at Official WhatsApp API and coexistence.
Your system calls WPP Marketing to send text or media messages and to query message histories and webhook deliveries.
Your system sends commercial events such as order created, payment approved, shipment, or abandoned cart.
Understand the available events and automationsWPP Marketing sends standardized creation, delivery, read, and error events to a URL you provide.
See return events and delivery trackingUse the interactive documentation to validate payloads, authentication, and responses before deploying to production.
Tokens must stay on the backend. Do not expose credentials in public pages, front-end apps, or repositories.
In /send-text and /send-media, Idempotency-Key lets you repeat the same request with a successful response for up to 48 hours. Reusing the key with different content returns 409. Without the key, retrying the call may duplicate the send. Observe the RateLimit and Retry-After headers; request limits differ from plan quota.
One credential per integration, with the necessary permissions.
In the dashboard, name the token, select the scopes, and set an optional expiration. The full token is shown only once at creation. The list lets you check last use, expiration, and revoke access when needed.
When rotating a credential, update the secret on your server and revoke the previous one. Never use the WhatsApp provider token in place of the API credential.
Allows sending text and media. Grant only to integrations that need to initiate sends.
They allow viewing, respectively, the message history and webhook deliveries. A sending credential does not receive these permissions automatically.
Allows sending customers, carts and orders via the Events API to automations configured in the account.
Inspects stored settings, automations, counts, and recent logs for diagnostics. May include personal data and message content: grant only to authorized integrations and support. This query does not check the provider connection live.
MCP and Official WhatsApp API.
Connect AI tools to your WhatsApp operations with WPP Marketing's MCP. Integrate WhatsApp into your assistants' and agents' workflows, using the Official API as the messaging connection.
MCP connects your agents' flows to the integration; the messaging API performs the sendings and the official connection follows WhatsApp's rules. This does not turn the MCP into a native chatbot nor replace account setup. The team guides the actions and integration requirements for your use case.
Use MCP as the integration path between AI tools and WhatsApp, complementing your systems' and team's flows.
Talk with our team about the AI tool you use and the actions you want to connect to WhatsApp. Check the requirements and the appropriate scope for your operation.
Talk about MCP integrationReady to integrate your system with WPP Marketing?
Open the Swagger to view Messaging API endpoints, payload examples, bearer token authentication, and expected responses. For shop events and delivery feedback, also see Events API and Webhooks de status.