API Reference

Meta Ads / API Reference

meta_ads_send_whatsapp_message

Meta Ads tool. Send a WhatsApp message via Meta WhatsApp Business Cloud API. Requires a WhatsApp Business Account (WABA) with messaging permissions. For outbound messages to new contacts, use template_name (pre-approved templates only). Free-form text only works within 24h customer service window. Args: phone_number_id: WhatsApp Business phone number ID from WABA (required). to: Recipient phone number with country code, e.g. '972501234567' (required). message_type: 'text' or 'template'. Default 'text'. text: Message text for text type messages. template_name: Approved template name for template messages. template_language: Template language code. Default 'he' (Hebrew). template_components: JSON array of template components for dynamic values. access_token: WhatsApp System User access token. Required — different from Meta Ads token.

This is a write tool: it sends whatsapp message in your Meta Ads account. Claude asks you to confirm before it runs.

Ask Claude

You do not call this tool yourself. Ask for the outcome and the client picks the tool:

Send whatsapp message in my Meta Ads account for [phone number id], [to].

It takes 2 required and 6 optional parameters.

Parameters

ParameterTypeRequiredDescription
phone_number_idstringYesPhone Number Id
tostringYesTo
message_typestringNoMessage Type
textstringNoText
template_namestringNoTemplate Name
template_languagestringNoTemplate Language
template_componentsstringNoTemplate Components
access_tokenstringNoAccess Token

Related Meta Ads tools

Before you can call it

This tool needs a connected Meta Ads account. The Meta Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.

Workflows that use this

Rather than calling tools one at a time, these skills run a whole procedure against the same account:

Start using MCP Ads