Changelog
What changed in the Mawgood API.
21 November 2026
api.mawgood.ai/v1/…now reaches the API directly (it was redirected to the website, soPOST /v1/mcpfailed). Any other path onapi.mawgood.aianswers404 not_found;/opens these docs.- CORS for the API reference's Try it (from
https://docs.mawgood.aionly; use a test key). GET /numbersreturnsphonein E.164 (+15551883313), never WhatsApp's display form.- Test keys now get every check a live key gets,
split_requiredandnot_readyincluded, before403 test_key_cannot_send. - New secret keys start with
campaigns:send,campaigns:read,templates:readandnumbers:readticked.
v1 — November 2026 (Beta)
The first public version of the Mawgood API.
GET /me,GET /numbers,GET /templates(filter bystatus,name,language).POST /campaignsto one number or up to 10,000: a requiredIdempotency-Key(24 hours,idempotent-replay: trueon a replay), scheduling, optionalpacing, values sent as given and checked against WhatsApp's rules up front, local Egyptian numbers read as+20, andskippednumbers (invalid_number,duplicate) in the answer.GET /campaigns/{id},GET /campaigns/{id}/recipients,POST /campaigns/{id}/cancel, for any campaign of the workspace (source:apiordashboard).- Utility templates skip quiet hours and the frequency cap, for dashboard campaigns too; opt-outs apply to every template.
- Signed webhooks for every campaign:
message.status,message.replied,campaign.started,campaign.rejected,campaign.completed,campaign.paused,campaign.failed,campaign.cancelled, and thepingtest event. Retries for 24 hours, a delivery log with resend in Settings › Developers, andGET /webhooks/deliveries. - Remote MCP server at
https://api.mawgood.ai/v1/mcpwith preview-then-send. - Live (
mwg_sk_live_) and test (mwg_sk_test_) keys. Test keys check a send fully and answer403 test_key_cannot_send; in the MCP they preview but don't send. - Not sendable yet: carousel, catalog and multi-product templates, limited-time offers that count down, and authentication templates.
During the beta we may add fields and events. We won't remove or rename anything documented here without a new version.