Skip to Content
Developer docsBeta

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, so POST /v1/mcp failed). Any other path on api.mawgood.ai answers 404 not_found; / opens these docs.
  • CORS for the API reference's Try it (from https://docs.mawgood.ai only; use a test key).
  • GET /numbers returns phone in E.164 (+15551883313), never WhatsApp's display form.
  • Test keys now get every check a live key gets, split_required and not_ready included, before 403 test_key_cannot_send.
  • New secret keys start with campaigns:send, campaigns:read, templates:read and numbers:read ticked.

v1 — November 2026 (Beta)

The first public version of the Mawgood API.

  • GET /me, GET /numbers, GET /templates (filter by status, name, language).
  • POST /campaigns to one number or up to 10,000: a required Idempotency-Key (24 hours, idempotent-replay: true on a replay), scheduling, optional pacing, values sent as given and checked against WhatsApp's rules up front, local Egyptian numbers read as +20, and skipped numbers (invalid_number, duplicate) in the answer.
  • GET /campaigns/{id}, GET /campaigns/{id}/recipients, POST /campaigns/{id}/cancel, for any campaign of the workspace (source: api or dashboard).
  • 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 the ping test event. Retries for 24 hours, a delivery log with resend in Settings › Developers, and GET /webhooks/deliveries.
  • Remote MCP server at https://api.mawgood.ai/v1/mcp with preview-then-send.
  • Live (mwg_sk_live_) and test (mwg_sk_test_) keys. Test keys check a send fully and answer 403 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.

On this page