Post to WhatsApp Business via MCP

WhatsApp Business is pending approval and is not yet available for publishing. This platform is awaiting Meta App Review. Attempts to publish to WhatsApp will return an error until approval is granted.

This guide is published in advance and describes the intended contract once the platform goes live. Do not build an integration against it expecting it to work today. Check the Supported Platforms page for current status.

Quick navigation: Which path should I use? · Multi-platform example · Recovery playbook · All 8 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