Post to WhatsApp Business via MCP

Quick navigation: Which path should I use? · Multi-platform example · Recovery playbook · All 9 platforms at a glance

Prerequisites: VoxBurst MCP server configured. See MCP Server setup.

VoxBurst posts to WhatsApp Business only via the WhatsApp Business API (Cloud API). Personal WhatsApp accounts are not supported. Connecting requires a WhatsApp Business Account (WABA) with Meta Business verification completed.

The complete flow

Find the WhatsApp account ID


list_accounts()

Look for "platform": "whatsapp". The displayName will show your business name and username will show the registered phone number.

Optionally validate content first


validate_content(
  content: "Your message text",
  platforms: ["WHATSAPP"]
)

Create the post

See post type examples below.

Check the result


get_post(postId: "post_abc123")


{
  "id": "post_abc123",
  "status": "published",
  "platforms": [
    {
      "platform": "whatsapp",
      "status": "published",
      "platformPostUrl": null,
      "publishedAt": "2026-06-07T10:00:05Z",
      "error": null
    }
  ]
}

platformPostUrl is always null for WhatsApp — the Business API does not expose public post URLs.

What type of post do you want?

I want to post…	contentType	Media required?	Notes
Text only	`TEXT`	No	Max 4,096 chars
Image(s)	`IMAGE`	Yes — 1–30 images	Max 5 MB per image; JPEG or PNG
A video	`VIDEO`	Yes — 1 video	Max 16 MB; max 3 minutes; MP4 recommended

WhatsApp does not support first comments, carousels, Reels, Stories, or threads via VoxBurst. First comments set via firstComment will be silently skipped.

Media input options:

mediaUrls — public HTTPS image/video URLs (auto-registered)
mediaIds — VoxBurst media IDs from prior uploads

Post type examples

Text post


create_post(
  content: "VoxBurst 2.0 is live — unified social scheduling across every platform. Visit voxburst.io to learn more.",
  accountIds: ["acc_whatsapp_abc123"],
  contentType: "TEXT"
)

Image post


create_post(
  content: "Announcing our product launch. See the image for details.",
  accountIds: ["acc_whatsapp_abc123"],
  contentType: "IMAGE",
  mediaUrls: ["https://cdn.example.com/launch-banner.jpg"]
)

Multiple images


create_post(
  content: "Here are three highlights from the summit.",
  accountIds: ["acc_whatsapp_abc123"],
  contentType: "IMAGE",
  mediaUrls: [
    "https://cdn.example.com/summit-1.jpg",
    "https://cdn.example.com/summit-2.jpg",
    "https://cdn.example.com/summit-3.jpg"
  ]
)

Video post


create_post(
  content: "Watch our 2-minute product walkthrough.",
  accountIds: ["acc_whatsapp_abc123"],
  contentType: "VIDEO",
  mediaIds: ["media_walkthrough_abc123"]
)

Scheduled post


create_post(
  content: "Our weekly update is ready. Check it out at voxburst.io/blog.",
  accountIds: ["acc_whatsapp_abc123"],
  contentType: "TEXT",
  scheduledFor: "2026-06-09T09:00:00Z"
)

Tell your AI agent this

Text post, post now:

Post to WhatsApp Business account [acc_id]. Content: [your message]. Post now.

Image, scheduled:

Post to WhatsApp Business account [acc_id]. Content: [text]. Attach image: [https://...]. Schedule for [ISO timestamp].

Failure cookbook

Error	Cause	Fix
`WABA_NOT_VERIFIED`	Business account not verified by Meta	Complete Meta Business verification at business.facebook.com
`PHONE_NUMBER_NOT_REGISTERED`	Phone number not registered to WABA	Register the phone number in Meta Business Suite
`OAUTH_TOKEN_EXPIRED`	Access token expired	Re-connect the WhatsApp account in VoxBurst Settings
`MEDIA_TOO_LARGE`	Image over 5 MB or video over 16 MB	Compress or resize before uploading
`VIDEO_TOO_LONG`	Video over 3 minutes	Trim to under 3 minutes
`CONTENT_TOO_LONG`	Over 4,096 characters	Shorten the message
`INSUFFICIENT_PERMISSIONS`	Missing WhatsApp Business API scopes	Re-connect the account and approve all required permissions
Post status `failed`	WhatsApp API error	Read `platforms[].error`; call `retry_post` for transient failures

Account requirements

Requirement	Detail
Account type	WhatsApp Business Account (WABA)
Auth method	OAuth 2.0 via Meta Graph API
Key precondition	Meta Business verification required; a registered phone number ID must be associated with the WABA
Re-connect trigger	Access token expires or WABA permissions change; re-connect in VoxBurst Settings

WhatsApp Business API credentials are managed at the workspace level. Your VoxBurst admin can configure the WHATSAPP_APP_ID and WHATSAPP_APP_SECRET in the admin panel, or you can use VoxBurst-managed OAuth (where available).

When WhatsApp Business is a poor fit

Personal WhatsApp — the Business API only works with verified WABA accounts; personal accounts cannot be connected
Carousel posts — not supported; use multiple images in a single IMAGE post instead
First comment CTAs — first comments are not supported; include the CTA in the post body
Public post URLs — WhatsApp does not expose public URLs for published posts; platformPostUrl is always null
High-frequency public broadcasting — WhatsApp Business API has rate limits and is best suited for business notifications rather than mass-market content distribution

Cross-platform override example

WhatsApp typically works best with concise, conversational messaging without hashtags:


create_post(
  content: "New update available for all users.",
  accountIds: ["acc_whatsapp_abc123", "acc_instagram_def", "acc_linkedin_ghi"],
  contentType: "IMAGE",
  mediaUrls: ["https://cdn.example.com/update-banner.jpg"],
  platformOverrides: {
    "WHATSAPP": {
      "content": "VoxBurst update is live. Visit voxburst.io/changelog to see what changed."
    },
    "INSTAGRAM": {
      "content": "Major update just dropped ✨ Link in bio for the full changelog. #voxburst #productupdate",
      "firstComment": "Full changelog: https://voxburst.io/changelog"
    },
    "LINKEDIN": {
      "content": "We shipped a significant update today. Here is what changed and why it matters for teams managing social at scale."
    }
  }
)

See the same post across all platforms guide for a full 9-platform example.

Benchmark checklist

Last updated: 2026-06-07 — WhatsApp Business graduated from Early Access to Live.


Supported content types	`TEXT`, `IMAGE` (1–30), `VIDEO`
Unsupported content types	`CAROUSEL`, `REEL`, `STORY`; first comments not supported
Validation gotcha	Max 4,096 characters; images max 5 MB (JPEG/PNG); video max 16 MB / 3 min
Media gotcha	MP4 strongly recommended for video; other formats may be rejected by WhatsApp
Account gotcha	Requires Meta Business verification and a registered WABA phone number — personal accounts cannot connect
Example prompt	”Post to WhatsApp Business account acc_id. Content: text. Post now.”
Example tool call	`create_post(content: "...", accountIds: ["acc_whatsapp_abc"], contentType: "TEXT")`
Example response	`{ "status": "published", "platforms": [{ "platform": "whatsapp", "platformPostUrl": null }] }`
Recovery path	`retry_post` for transient errors; re-connect account for OAuth token failures