> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp

> Enables interaction with customers through the WhatsApp Business API for messaging and automation. Only supports WhatsApp Business accounts, not WhatsApp Personal accounts.

![WhatsApp logo](https://mintcdn.com/composio-preview/DMB8UrgJmE7r-ZQ5/images/toolkits/whatsapp.svg?fit=max\&auto=format\&n=DMB8UrgJmE7r-ZQ5\&q=85\&s=f7942b069802183ca61f1a16c01a2099)

* **Category:** phone & sms
* **Auth:** OAUTH2, API\_KEY
* **Composio-managed OAuth available?** Yes
* **Tools:** 58
* **Triggers:** 1
* **Slug:** `WHATSAPP`
* **Version:** 20261101\_00

## Frequently Asked Questions

> [accordion] Why isn't my WhatsApp message being delivered?
>
> WhatsApp has a 24-hour customer service window. Recipients only receive messages within 24 hours of their last message to you. To message outside this window, use a template message.

> [accordion] Can I use a personal WhatsApp account with the WhatsApp toolkit?
>
> No. The WhatsApp toolkit is for WhatsApp Business API flows, so the connected account needs to be backed by a WhatsApp Business Account (WABA). Personal WhatsApp accounts are not supported for these API flows.
>
> If you need to send or receive WhatsApp messages through the toolkit, set up or connect the relevant WABA-backed business account in Meta first.

> [accordion] What is a WABA ID?
>
> The WABA ID, or WhatsApp Business Account ID, is required because the WhatsApp Business API needs it to identify the business account. Users can find it in Meta Developers under the app's WhatsApp API Setup section, or fetch it programmatically by calling `GET /me/businesses` and then `GET /{business_id}/owned_whatsapp_business_accounts` with an access token.

> [accordion] WhatsApp template messages require an existing template before sending
>
> Sending a WhatsApp template message requires a template to already exist in WhatsApp/Meta. The send-template tool sends an existing template by name/language and parameters; it does not remove the need to create and approve the template first.

> [accordion] Why is my WhatsApp connection failing with "Missing required fields"?
>
> Ensure all required fields are provided when initiating the connection. See the [WhatsApp authentication details](https://composio-preview.mintlify.site/toolkits/whatsapp).

## Tools

> [accordion] Accept business solution
>
> **Slug:** `WHATSAPP_ACCEPT_BUSINESS_SOLUTION`
>
> Accept an invitation for the authenticated partner app to join a Multi-Partner Solution. Requires an eligible Solution Partner, Tech Provider, or Tech Partner and an invited app; the solution must be INITIATED. Review the solution's name and owner/partner permissions before acceptance: accepted solutions cannot then be declined. Acceptance changes partner status to ACCEPTED and may activate the solution once all required partners accept. If the app will access onboarded client data, Meta additionally requires App Review approval for both whatsapp\_business\_management and whatsapp\_business\_messaging.
>
> #### Input Parameters
>
> **solution\_id** `string` *required*
>
> Multi-Partner Solution ID from the invitation, partner\_solutions webhook's solution\_id, or Partner solutions panel in the Meta App Dashboard.
>
> **log\_session\_id** `string`
>
> Optional logging/debugging session identifier to track the acceptance flow across API calls.
>
> **partner\_app\_id** `string` *required*
>
> Meta app ID of the invited partner accepting the solution. Must match the app that received the invitation; find it in the Meta App Dashboard.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Accept solution deactivation
>
> **Slug:** `WHATSAPP_ACCEPT_SOLUTION_DEACTIVATION`
>
> Accept a pending Multi-Partner Solution deactivation request. Completes the partner approval workflow: ACTIVE/PENDING\_DEACTIVATION becomes DEACTIVATED/NONE. The solution can no longer onboard clients through Embedded Signup. Requires an eligible partner setup and authorization for the solution; the multi-partner guide specifies solution-owner access. Outstanding payments must be settled and active campaigns concluded or transferred. Meta notifies partners and cleans up solution resources and permissions. Returns solution state, optionally restricted by fields, or a success acknowledgment as shown in the multi-partner guide. This does not initiate deactivation.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated response fields: id, name, status, status\_for\_pending\_request, owner\_permissions. Omit for provider defaults: name,status,status\_for\_pending\_request.
>
> **solution\_id** `string` *required*
>
> Multi-Partner Solution ID from WHATSAPP\_LIST\_BUSINESS\_SOLUTIONS, the Meta App Dashboard's Partner solutions panel, or a partner\_solutions webhook's solution\_id. Requires an ACTIVE solution with PENDING\_DEACTIVATION.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add business phone number
>
> **Slug:** `WHATSAPP_ADD_BUSINESS_PHONE_NUMBER`
>
> Add a preverified phone number to a partner-owned pool clients can purchase from. This partner inventory endpoint creates a preverified phone number entity for a WhatsApp Business Account. It is not ordinary WABA phone registration or an SMS verification workflow. The number must not already be registered to another WhatsApp Business Account.
>
> #### Input Parameters
>
> **user\_agent** `string`
>
> Optional User-Agent header identifying the client software.
>
> **business\_id** `string` *required*
>
> WhatsApp Business Account ID used as Business-ID by this partner endpoint. Find it in Meta Business Manager or via the business management APIs.
>
> **phone\_number** `string` *required*
>
> Preverified partner-owned phone number to add. Accepts E.164 or formatted numbers with spaces, hyphens, and parentheses (for example, +1 (631) 555-1000); the provider normalizes and validates it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Approve group join requests
>
> **Slug:** `WHATSAPP_APPROVE_GROUP_JOIN_REQUESTS`
>
> Approve pending WhatsApp group join requests by their join request IDs. Use for groups requiring join approval. Approved users can access the group when tapping its invite link. Requires a Groups API-eligible business number. HTTP 200 can include partial failures: inspect approved\_join\_requests, failed\_join\_requests, and errors to determine the outcome for each request.
>
> #### Input Parameters
>
> **group\_id** `string` *required*
>
> Group ID from the active groups listing or group creation webhook.
>
> **join\_requests** `array` *required*
>
> Join request IDs to approve. Obtain these from the group's open join requests listing or group\_participants\_update webhooks; these are not WhatsApp user IDs.
>
> **messaging\_product** `string`
>
> Messaging product; must be whatsapp.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Assign user
>
> **Slug:** `WHATSAPP_ASSIGN_USER`
>
> Assign a Facebook user or system user to a WhatsApp Business Account with specified tasks. Grants account access for the supplied permission tasks. Authenticate using a System User access token with admin permissions and provide the intended Facebook user or system user ID. Returns the provider's success flag.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> Facebook user or system user ID to add. Find Facebook user IDs in Meta business settings or business user management APIs; retrieve system user IDs from /\{WHATSAPP\_BUSINESS\_ACCOUNT\_ID}/system\_users. Authenticate using a System User access token with admin permissions.
>
> **tasks** `array` *required*
>
> Permission tasks to grant to the user on the WhatsApp Business Account. MANAGE\_BILLING is needed for sharing a Line of Credit. Request the needed granular tasks; MANAGE requires full solution access including MESSAGING for shared Multi-Partner Solutions.
>
> **whatsapp\_business\_account\_id** `string` *required*
>
> WhatsApp Business Account ID. Find it in Meta Business Manager or account management APIs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Block WhatsApp Users
>
> **Slug:** `WHATSAPP_BLOCK_USERS`
>
> Block one or more WhatsApp users to prevent them from sending messages to your business phone number. Use this action when you need to prevent specific users from contacting your business through WhatsApp. Blocked users will receive an error if they attempt to send messages to your business phone number. This action is irreversible — blocked users cannot unblock themselves and must contact your business directly to be unblocked. Note: You can block a maximum of 100 users per request.
>
> #### Input Parameters
>
> **block\_users** `array` *required*
>
> List of users to block. Each user must be identified by their WhatsApp phone number in international format without the + sign (e.g., '16505551234'). Maximum of 100 users per request.
>
> **phone\_number\_id** `string` *required*
>
> The Meta-assigned numeric ID for the WhatsApp Business phone number to block users from. This is NOT the actual phone number itself - it is a numeric ID (e.g., '712594308615206') assigned by Meta. Obtain it using WHATSAPP\_GET\_PHONE\_NUMBERS action which returns the 'id' field for each phone number.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Configure WhatsApp Conversational Automation
>
> **Slug:** `WHATSAPP_CONFIGURE_CONVERSATIONAL_AUTOMATION`
>
> Configure conversational automation for a WhatsApp Business phone number, including welcome-message enablement, custom commands, and ice breaker prompts. The welcome-message setting defaults to false when omitted.
>
> #### Input Parameters
>
> **prompts** `array`
>
> List of conversation prompts (ice breakers) up to 3 items. Each prompt must be 1-80 characters. These guide customers with suggested conversation starters.
>
> **commands** `array`
>
> List of bot commands (up to 30) for automated responses. Each command has a name and description. Use this to define custom commands users can trigger.
>
> **phone\_number\_id** `string` *required*
>
> The Meta-assigned numeric ID for the WhatsApp Business phone number (e.g., '1234567890123456'). Get this from the WHATSAPP\_GET\_PHONE\_NUMBERS action.
>
> **enable\_welcome\_message** `boolean`
>
> Whether to enable the welcome message for new conversations. When enabled, the first message from a customer will trigger an automated greeting.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create business account
>
> **Slug:** `WHATSAPP_CREATE_BUSINESS_ACCOUNT`
>
> Create a WhatsApp Business Account under a business portfolio. Requires portfolio permissions and an app capable of WABA creation. The new account remains pending until verification completes. Returns the WABA and payment account IDs; does not register a phone number or send messages.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Human-readable account name; must be unique within the business portfolio.
>
> **currency** `string`
>
> Billing currency code in ISO 4217 format.
>
> **business\_id** `string` *required*
>
> Business portfolio ID. Find it in Meta Business Suite business settings or business management APIs.
>
> **timezone\_id** `integer`
>
> Meta timezone ID for the account.
>
> **business\_type** `string ("ENTERPRISE" | "SMB")`
>
> WhatsApp Business Account type: ENTERPRISE or SMB.
>
> **primary\_funding\_id** `string`
>
> Primary funding source ID (credit card or extended credit), available from your business billing settings. The source must be valid and active.
>
> **purchase\_order\_number** `string`
>
> Purchase order number for billing reference.
>
> **on\_behalf\_of\_business\_id** `string`
>
> Business portfolio ID when creating on behalf of another business. Find it in that business's Meta Business Suite settings.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create business solution
>
> **Slug:** `WHATSAPP_CREATE_BUSINESS_SOLUTION`
>
> Create a Multi-Partner Solution between an owner app and a partner app. Requires an eligible Solution Partner, Tech Provider, or Tech Partner setup and an accessible partner app. Assign MESSAGING to exactly one app. Creation initiates the solution and invites the partner; the partner must accept before it can be used with Embedded Signup. Returns the solution ID, not an active solution.
>
> #### Input Parameters
>
> **solution\_name** `string` *required*
>
> Agreed human-readable solution name shown in both partners' dashboards (2–75 characters).
>
> **application\_id** `string` *required*
>
> Solution owner Facebook app ID. Find it in your Meta App Dashboard; the app must have the required partner capabilities.
>
> **partner\_app\_id** `string` *required*
>
> Partner Facebook app ID, obtained from your agreed solution partner's Meta App Dashboard. The app must be accessible to the requesting entity.
>
> **owner\_permissions** `array` *required*
>
> Configurable permissions for the owner app: \['MESSAGING'] or \[]. Exactly one of owner\_permissions and partner\_permissions must contain MESSAGING; default partner permissions are automatic.
>
> **partner\_permissions** `array` *required*
>
> Configurable permissions for the partner app: \['MESSAGING'] or \[]. Use \[] when the owner handles messaging; exactly one app must receive MESSAGING.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create WhatsApp Flow
>
> **Slug:** `WHATSAPP_CREATE_FLOW`
>
> Create a WhatsApp Flow for the WhatsApp Business Account bound to the connection. The flow starts in draft and must be configured with Flow JSON and published before use.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the flow. Maximum 80 characters. Must be unique within your WhatsApp Business Account.
>
> **waba\_id** `string`
>
> Optional: WhatsApp Business Account ID to use. If not provided, uses the waba\_id from your connection configuration.
>
> **categories** `string` *required*
>
> JSON array of category names as a string (e.g., '\["OTHER"]'). Each flow must have at least one category. Common categories include: AUTHENTICATION, CONFIRMATION, LEAD\_GENERATION, OTHER, etc.
>
> **endpoint\_uri** `string` *required*
>
> The HTTPS URL where your flow logic is hosted. This endpoint must be accessible by Meta's servers. The URL must start with https\:// and should respond to incoming flow data requests.
>
> **clone\_flow\_id** `string`
>
> Optional: ID of an existing flow to clone. If provided, the new flow will be a copy of the specified flow with the new name and categories. Use this to quickly create variations of existing flows.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create group
>
> **Slug:** `WHATSAPP_CREATE_GROUP`
>
> Submit creation of a WhatsApp group for a business phone number. Requires an eligible Official Business Account using Cloud API. A successful response acknowledges the creation request; the group\_lifecycle\_update webhook reports creation success or failure and supplies the invite link on success. Omitted join\_approval\_mode defaults to auto\_approve at WhatsApp.
>
> #### Input Parameters
>
> **subject** `string` *required*
>
> Group subject, at most 128 characters. WhatsApp trims whitespace.
>
> **description** `string`
>
> Optional group description, at most 2048 characters.
>
> **phone\_number\_id** `string` *required*
>
> Business phone number ID. Obtain it from WHATSAPP\_GET\_PHONE\_NUMBERS or WhatsApp Manager.
>
> **messaging\_product** `string` *required*
>
> Messaging product; must be whatsapp.
>
> **join\_approval\_mode** `string ("approval_required" | "auto_approve")`
>
> Whether joining via the invite link requires approval. If omitted, WhatsApp defaults to auto\_approve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create group invite link
>
> **Slug:** `WHATSAPP_CREATE_GROUP_INVITE_LINK`
>
> Reset a WhatsApp group's invite link and return its replacement. POST creates a new invite link for an existing group, invalidating all previous invite links. A group's initial link is generated when the group is created. This action rotates that link; it does not retrieve the current link, create a group, or send invitations. Requires an eligible Official Business Account using Cloud API.
>
> #### Input Parameters
>
> **group\_id** `string` *required*
>
> Group ID from the group\_lifecycle\_update webhook or a group listing/query response. This operation resets that group's invite link.
>
> **messaging\_product** `string` *required*
>
> Messaging product; must be whatsapp.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create WhatsApp Max Price Agreement
>
> **Slug:** `WHATSAPP_CREATE_MAX_PRICE_AGREEMENTS`
>
> Create a max price agreement for WhatsApp marketing messages pricing. Max price agreements set a ceiling on the per-conversation price you'll pay for WhatsApp messaging across your WhatsApp Business Account. This is useful for controlling costs and ensuring predictable pricing for your messaging campaigns. Use this action when you need to set up pricing agreements for marketing, utility, or authentication message types on your WhatsApp Business Account. Once created, the agreement will be applied to all applicable conversations.
>
> #### Input Parameters
>
> **currency** `string` *required*
>
> The 3-letter ISO currency code for the max price (e.g., 'USD', 'EUR', 'INR').
>
> **business\_id** `string` *required*
>
> The WhatsApp Business Account (WABA) ID. This is the numeric ID for your business account, typically starts with a number like '944953772041385'.
>
> **signer\_name** `string` *required*
>
> The full name of the person signing this price agreement.
>
> **message\_type** `string ("marketing" | "utility" | "authentication")` *required*
>
> The type of message for this price agreement. Use 'marketing' for promotional messages, 'utility' for transactional updates, or 'authentication' for one-time passwords.
>
> **signer\_email** `string` *required*
>
> The email address of the person signing this price agreement. This person will receive confirmation of the agreement.
>
> **max\_price\_micros** `integer` *required*
>
> The maximum price in micros (1 million micros = 1 unit of currency). For example, 50000 micros = 0.05 in the specified currency.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create message template
>
> **Slug:** `WHATSAPP_CREATE_MESSAGE_TEMPLATE`
>
> Create a new message template for the WhatsApp Business Account. Templates must be approved by WhatsApp before they can be used. Templates are required for marketing messages and messages sent outside the 24-hour window.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Unique template name. Must be lowercase, alphanumeric with underscores only. Maximum 512 characters. Example: 'order\_confirmation\_v1'.
>
> **category** `string ("AUTHENTICATION" | "MARKETING" | "UTILITY")` *required*
>
> Template category. AUTHENTICATION: for OTP/verification codes. MARKETING: for promotional content (requires opt-in). UTILITY: for transactional updates like order status, appointments.
>
> **language** `string` *required*
>
> Template language code in ISO 639-1 format with country code. Examples: 'en\_US' (US English), 'es\_ES' (Spanish), 'pt\_BR' (Brazilian Portuguese).
>
> **components** `array`
>
> List of template components. Required when creating a template from scratch: must include at least one BODY component, and can optionally include one HEADER and one BUTTONS component. Omit when cloning a Template Library template via library\_template\_name.
>
> **allow\_category\_change** `boolean`
>
> Optional. Set to true to allow Meta to automatically assign/reassign the template category. If omitted, the template may be rejected due to miscategorization.
>
> **library\_template\_name** `string`
>
> Optional. The exact name of a Meta Template Library template to clone (e.g. 'order\_confirmation\_2'). When set, the template is created from the pre-approved library template instead of from scratch; components should be omitted.
>
> **library\_template\_body\_inputs** `object`
>
> Optional. Used with library\_template\_name. Object supplying body-level inputs for the library template (e.g. \{'add\_contact\_number': true, 'add\_learn\_more\_link': true, 'add\_security\_recommendation': true, 'add\_track\_package\_link': true, 'code\_expiration\_minutes': 10}).
>
> **library\_template\_button\_inputs** `array`
>
> Optional. Used with library\_template\_name. List of button input objects supplying values for the library template's buttons (e.g. \[\{'type': 'PHONE\_NUMBER', 'phone\_number': '+15551234567'}] or \[\{'type': 'URL', 'url': '[https://example.com](https://example.com)'}]).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create obo mobility intent
>
> **Slug:** `WHATSAPP_CREATE_OBO_MOBILITY_INTENT`
>
> Create an On-Behalf-Of mobility intent for an eligible WhatsApp Business Account. Requires an authorized solution provider with access to the WABA and source/target solutions in an eligible state. Initiates a transfer, handover, or related approval or cancellation operation. May trigger partner notifications and approval workflows; successful creation does not mean account migration has completed. The legacy OBO account ownership model is deprecated and replaced by partner-initiated account creation; this v23 endpoint is documented, but eligibility must be confirmed with the provider for the account before use.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> Mobility intent JSON body, including the source solution and operation type.
>
> **waba\_id** `string` *required*
>
> WhatsApp Business Account ID; discover via owned or shared business account listings. Requires an eligible account accessible to the authorized solution provider.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create phone number
>
> **Slug:** `WHATSAPP_CREATE_PHONE_NUMBER`
>
> Create a phone number registration within a WhatsApp Business Account. Starts onboarding, phone verification (unless pre-verified), and business name review. The account must have an available phone number slot and the number must not already be registered with WhatsApp Business. Can also initiate an on-premises-to-Cloud API migration. Use the phone number GET endpoint to monitor registration status; creation does not imply approval.
>
> #### Input Parameters
>
> **cc** `string`
>
> Country code for the phone number.
>
> **waba\_id** `string` *required*
>
> WhatsApp Business Account ID where the number will be added. Find it in WhatsApp Manager or the business management APIs.
>
> **phone\_number** `string` *required*
>
> Phone number in E.164 format without the + prefix.
>
> **verified\_name** `string` *required*
>
> Business name to be verified for this phone number.
>
> **preverified\_id** `string`
>
> Pre-verified phone number ID for Business Solution Provider (BSP) scenarios; obtain it from your pre-verification workflow.
>
> **migrate\_phone\_number** `boolean`
>
> Whether this is a migration from the on-premises API to Cloud API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create QR Code
>
> **Slug:** `WHATSAPP_CREATE_QR_CODE`
>
> Create a new QR code with a prefilled message for a WhatsApp Business phone number. Use this action when you need to generate a shareable QR code that customers can scan to start a conversation with your business. When scanned, the QR code will automatically populate the message input field with the specified prefilled message, making it easy for customers to initiate contact. The QR code can be configured to generate an image (PNG or SVG format) which will be available in the response for download and sharing.
>
> #### Input Parameters
>
> **phone\_number\_id** `string` *required*
>
> The WhatsApp Business Account phone number ID for which to create the QR code. This ID is provided when you add a phone number to your WhatsApp Business Account.
>
> **generate\_qr\_image** `string`
>
> Optional. Image format for the generated QR code. When specified, the response will include a qr\_image\_url field with the QR code image. Supported values: 'PNG' or 'SVG'.
>
> **prefilled\_message** `string` *required*
>
> The pre-filled message text that will appear when customers use the QR code. This is the message they will send to your business when they scan the code.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create schedule
>
> **Slug:** `WHATSAPP_CREATE_SCHEDULE`
>
> Create a campaign schedule for the connection's WhatsApp Business Account. Supply a template (HSM), audience, WABA customer status ID, name, description, and delivery Unix timestamp. Returns the created schedule ID.
>
> #### Input Parameters
>
> **waba\_id** `string`
>
> WhatsApp Business Account ID from WhatsApp Manager. If supplied, must match the connection's WABA ID; otherwise the configured ID is used.
>
> **request\_body** `object` *required*
>
> Required JSON payload for creating a campaign schedule.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create upload session for WhatsApp
>
> **Slug:** `WHATSAPP_CREATE_UPLOAD_SESSION`
>
> Create a resumable upload session for large file uploads to WhatsApp. This action initiates an upload session that allows you to upload large files in chunks. First create a session, then use the session ID and URI to upload file data in subsequent requests. This is useful for uploading videos and large images that exceed the size limits of direct uploads. Use this action when you need to upload media files larger than the direct upload limit, or when you want to implement resumable uploads for reliability.
>
> #### Input Parameters
>
> **file\_name** `string`
>
> Optional file name for the upload session. If not provided, a default name will be used.
>
> **file\_type** `string ("image/jpeg" | "image/png" | "video/mp4")` *required*
>
> The MIME type of the file being uploaded. Supported types: image/jpeg, image/png, video/mp4.
>
> **file\_length** `integer` *required*
>
> The size of the file in bytes. Must be a positive integer representing the exact file size.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete flow
>
> **Slug:** `WHATSAPP_DELETE_FLOW`
>
> Delete a WhatsApp Flow that is in DRAFT status. Use the Flow ID returned by creating or listing Flows. Published Flows cannot be deleted; only DRAFT Flows are eligible for deletion.
>
> #### Input Parameters
>
> **flow\_id** `string` *required*
>
> ID of the Flow to delete. Obtain it from creating or listing Flows. Only Flows in DRAFT status can be deleted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete group
>
> **Slug:** `WHATSAPP_DELETE_GROUP`
>
> Delete a WhatsApp group and remove all participants, including the business. Use the group ID returned by listing groups or a group creation webhook. Requires an eligible Official Business Account using Cloud API. Final deletion success or failure is reported through the group\_lifecycle\_update webhook.
>
> #### Input Parameters
>
> **group\_id** `string` *required*
>
> ID of the WhatsApp group to delete. Obtain it from WHATSAPP\_LIST\_GROUPS or the group creation lifecycle webhook.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete group invite link
>
> **Slug:** `WHATSAPP_DELETE_GROUP_INVITE_LINK`
>
> Delete an existing WhatsApp group invite link using the Groups invite link API. Requires the group ID and an eligible Official Business Account using Cloud API. Deletes the invite link, not the group. To reset an invite link and obtain a replacement, use the POST invite link operation instead.
>
> #### Input Parameters
>
> **group\_id** `string` *required*
>
> ID of the WhatsApp group whose invite link to delete. Obtain it from the group creation lifecycle webhook or by listing groups.
>
> **messaging\_product** `string`
>
> Messaging product required by the invite link API. Must be whatsapp.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete WhatsApp Media
>
> **Slug:** `WHATSAPP_DELETE_MEDIA`
>
> Delete a WhatsApp media file previously uploaded via the Media API. Use when you need to remove a media object you uploaded earlier (e.g. to free up storage or to retract content). The deletion is permanent — the media\_id will no longer be retrievable. Note: media uploaded via Cloud API is normally retained by Meta for 30 days; this operation removes it before the automatic expiry.
>
> #### Input Parameters
>
> **media\_id** `string` *required*
>
> The WhatsApp media ID to delete (obtained from a prior upload\_media call or a webhook).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete message template
>
> **Slug:** `WHATSAPP_DELETE_MESSAGE_TEMPLATE`
>
> Delete a WhatsApp Business Account message template by name, permanently removing all language variants unless a template ID is supplied to target one variant. Deleted template names cannot be reused for 30 days.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the template to delete. This will delete all templates with this name across all languages.
>
> **hsm\_id** `string`
>
> Optional. The template's ID. Include this together with 'name' to delete only the single language variant with this template ID, instead of deleting all language variants sharing the name.
>
> **waba\_id** `string`
>
> WhatsApp Business Account ID to target. If not provided, the WhatsApp Business Account ID from the connection metadata is used.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete preverified number
>
> **Slug:** `WHATSAPP_DELETE_PREVERIFIED_NUMBER`
>
> Permanently delete a pre-verified phone number from the pre-verified list. Use the pre-verified node ID supplied by your BSP. Deletion cannot be undone and deleted numbers cannot be recovered. Ensure the number is not in active use before deleting it.
>
> #### Input Parameters
>
> **preverified\_phone\_number\_id** `string` *required*
>
> Pre-verified phone number ID supplied by your Business Solution Provider (BSP) during pre-verification. This is a node ID, not the phone number itself.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete QR Code
>
> **Slug:** `WHATSAPP_DELETE_QR_CODE`
>
> Delete a specific QR code from a WhatsApp Business phone number. Use this action when you need to permanently remove a QR code that is no longer needed. This operation is irreversible — once deleted, the QR code cannot be recovered or recreated with the same identifier. This action permanently deletes the QR code and cannot be undone.
>
> #### Input Parameters
>
> **qr\_code\_id** `string` *required*
>
> The unique 14-character identifier of the QR code to delete. This is the code value returned when the QR code was created.
>
> **phone\_number\_id** `string` *required*
>
> The WhatsApp Business Account phone number ID that owns the QR code to be deleted. This ID is provided when you add a phone number to your WhatsApp Business Account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Deprecate flow
>
> **Slug:** `WHATSAPP_DEPRECATE_FLOW`
>
> Irreversibly retire a published WhatsApp Flow by marking it DEPRECATED. The Flow must already be published. Deprecation prevents the Flow from being sent or opened, allowing its endpoint to be retired. A deprecated Flow cannot be deleted or restored to a previous state. Use WHATSAPP\_LIST\_FLOWS to find its ID and WHATSAPP\_GET\_FLOW to check its status before retiring it.
>
> #### Input Parameters
>
> **flow\_id** `string` *required*
>
> ID of the published Flow to retire. Obtain it from WHATSAPP\_LIST\_FLOWS or WHATSAPP\_CREATE\_FLOW, and check its status with WHATSAPP\_GET\_FLOW. Deprecation is irreversible.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Deregister WhatsApp Business Phone Number
>
> **Slug:** `WHATSAPP_DEREGISTER_PHONE`
>
> Deregister a WhatsApp Business phone number from the Cloud API. Use when you need to stop sending messages from a phone number — for example before migrating it to another WhatsApp Business Account, before re-registering with a new PIN, or when retiring the number. After deregistration, the phone number can be registered again via register\_phone. Destructive operation: after deregistration the phone number cannot send messages until it is registered again.
>
> #### Input Parameters
>
> **phone\_number\_id** `string` *required*
>
> The ID of the phone number to deregister (the same ID used with register\_phone).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download media
>
> **Slug:** `WHATSAPP_DOWNLOAD_MEDIA`
>
> Download a WhatsApp media asset using its short-lived media URL. First obtain the URL with WHATSAPP\_GET\_MEDIA\_INFO or a media webhook. Returns a downloadable file. URLs expire after five minutes; retrieve a new URL if the provider returns 404. Redirects are not followed.
>
> #### Input Parameters
>
> **media\_url** `string` *required*
>
> Absolute HTTPS media URL on lookaside.fbsbx.com returned by WHATSAPP\_GET\_MEDIA\_INFO or an incoming media webhook. URLs expire after 5 minutes; retrieve a fresh URL if expired.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Edit message template
>
> **Slug:** `WHATSAPP_EDIT_MESSAGE_TEMPLATE`
>
> Edit an existing WhatsApp message template by ID. Components, when supplied, replace ALL existing components. The management guide permits APPROVED, REJECTED, or PAUSED templates; approved templates cannot change category and are limited to 10 edits per 30 days and one per 24 hours. Rejected or paused templates have unlimited edits. Meta reviews changes to approved or paused templates and automatically re-approves them unless review fails. Eligibility and category-dependent limits are enforced by Meta against the existing template state.
>
> #### Input Parameters
>
> **category** `string ("AUTHENTICATION" | "FREE_SERVICE" | "MARKETING" | "UTILITY")`
>
> Updated category. The category of an APPROVED template cannot be edited; omit this field for approved templates.
>
> **components** `array`
>
> Complete replacement list of template component objects, not a partial component patch. Include all components to retain (HEADER, BODY, FOOTER, BUTTONS, or specialized components). Supply example values when using variables, and media handles for media headers. Component-specific fields such as buttons, examples, and carousel cards are preserved.
>
> **template\_id** `string` *required*
>
> Message template ID to edit. Discover IDs with WHATSAPP\_GET\_MESSAGE\_TEMPLATES.
>
> **sub\_category** `string ("BOOKING_STATUS" | "CALL_PERMISSIONS_REQUEST" | "FLIGHT_DELAY_AND_GATE_CHANGE_ALERT" | "FRAUD_ALERT" | "ORDER_DETAILS" | "ORDER_STATUS" | "RICH_ORDER_STATUS")`
>
> Template sub-category for utility templates.
>
> **display\_format** `string`
>
> Display format for the template.
>
> **parameter\_format** `string ("NAMED" | "POSITIONAL")`
>
> Parameter format for the template's variables.
>
> **allow\_category\_change** `boolean`
>
> Allow Meta to reassign the template category.
>
> **message\_send\_ttl\_seconds** `integer`
>
> Message time-to-live in seconds. Authentication: 30–900; utility: 30–43200; marketing (Marketing Messages API): 43200–2592000. Authentication and utility also accept -1 for 30 days. Limits depend on the existing template category, which need not be supplied in an edit.
>
> **cta\_url\_link\_tracking\_opted\_out** `boolean`
>
> Opt out of CTA URL link tracking.
>
> **is\_primary\_device\_delivery\_only** `boolean`
>
> Restrict delivery to the primary device only.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get account number
>
> **Slug:** `WHATSAPP_GET_ACCOUNT_NUMBER`
>
> Retrieve a WhatsApp Account Number node's status and configuration. Use an account-number ID from WHATSAPP\_GET\_PHONE\_NUMBERS. Returns account status, verification, quality, messaging tier, and certificates as selected with fields. For phone-number throughput and webhook settings instead, use WHATSAPP\_GET\_PHONE\_NUMBER.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated fields to retrieve. Omit for provider defaults: id, display\_phone\_number, status. Available: id, display\_phone\_number, verified\_name, status, quality\_rating, country\_code, country\_dial\_code, code\_verification\_status, name\_status, messaging\_limit\_tier, account\_mode, certificate, is\_official\_business\_account, host\_platform, is\_on\_biz\_app, is\_preverified\_number, last\_onboarded\_time, new\_certificate, new\_display\_name, new\_name\_status, platform\_type.
>
> **account\_number\_id** `string` *required*
>
> WhatsApp Account Number ID, obtained from WHATSAPP\_GET\_PHONE\_NUMBERS on your WhatsApp Business Account. Identifies the account-number entity, not a literal phone number; this operation retrieves account status and configuration rather than the phone-number node's throughput/webhook details.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get WhatsApp Business Account Activities
>
> **Slug:** `WHATSAPP_GET_ACTIVITIES`
>
> Retrieve a paginated activity history for the WhatsApp Business Account bound to the connection, including administrative actions such as phone number verifications and user additions.
>
> #### Input Parameters
>
> **after** `string`
>
> Cursor for pagination. Use this to get the next page of results.
>
> **limit** `integer`
>
> Maximum number of activity records to return per page. Default is 25, maximum is 100.
>
> **since** `string`
>
> Unix timestamp or ISO 8601 date string. Only return activities that occurred after this time.
>
> **until** `string`
>
> Unix timestamp or ISO 8601 date string. Only return activities that occurred before this time.
>
> **before** `string`
>
> Cursor for pagination. Use this to get the previous page of results.
>
> **fields** `string`
>
> Comma-separated list of fields to include in the response. Default includes all available fields.
>
> **waba\_id** `string`
>
> Optional: WhatsApp Business Account ID to query. If not provided, uses the waba\_id from your connection configuration.
>
> **activity\_type** `string`
>
> Filter activities by type. Can be a single type or comma-separated list of types (e.g., PHONE\_NUMBER\_VERIFIED,USER\_ADDED).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get assigned business accounts
>
> **Slug:** `WHATSAPP_GET_ASSIGNED_BUSINESS_ACCOUNTS`
>
> Retrieve one page of WhatsApp Business Accounts assigned to a specific Meta user. Returns account IDs and names. Use paging.cursors.after or before with the corresponding request parameter to navigate pages. The connected app must have permission to read the user's assigned accounts.
>
> #### Input Parameters
>
> **after** `string`
>
> Next-page cursor from paging.cursors.after.
>
> **limit** `integer`
>
> Maximum accounts per page, from 1 to 100. Provider default is 25.
>
> **before** `string`
>
> Previous-page cursor from paging.cursors.before.
>
> **fields** `string`
>
> Comma-separated response fields: id, name. Omit for provider defaults (id, name).
>
> **user\_id** `string` *required*
>
> Meta user ID whose assigned WhatsApp Business Accounts to retrieve. Find the user ID in your solution's or partnership's user management settings or Graph API user lookup.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get assigned users
>
> **Slug:** `WHATSAPP_GET_ASSIGNED_USERS`
>
> List users assigned to a WhatsApp Business Account in a business context. Returns user details and pagination. Pass an after or before cursor from the response to retrieve another page; this action fetches one page per call.
>
> #### Input Parameters
>
> **after** `string`
>
> Next-page cursor from paging.cursors.after.
>
> **limit** `integer`
>
> Users per page (1–100); provider default is 25.
>
> **before** `string`
>
> Previous-page cursor from paging.cursors.before.
>
> **fields** `string`
>
> Comma-separated response fields: id, name, business, user\_type. Provider defaults to id,name.
>
> **waba\_id** `string` *required*
>
> WhatsApp Business Account ID, found in WhatsApp Manager or account-listing APIs.
>
> **business** `string` *required*
>
> ID of the business owning or accessing the account; find it in Business Settings. Required business context.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get WhatsApp Business Account Details
>
> **Slug:** `WHATSAPP_GET_BUSINESS_ACCOUNT_DETAILS`
>
> Retrieve configuration and status details for the WhatsApp Business Account bound to the connection, including account review status, business verification status, timezone, and ownership details.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated list of fields to include in the response. Default includes all available fields.
>
> **waba\_id** `string`
>
> WhatsApp Business Account ID to retrieve details for. If not provided, uses the waba\_id from your connection configuration.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get business bot
>
> **Slug:** `WHATSAPP_GET_BUSINESS_BOT`
>
> Retrieve a WhatsApp Business Bot's prompts, commands and welcome-message setting. Supply the bot ID from Business Manager or bot creation/management APIs. Optionally select the documented node fields with a comma-separated fields string.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated fields to retrieve: id, prompts, commands, enable\_welcome\_message. Omit for the provider defaults (prompts, commands, enable\_welcome\_message).
>
> **waba\_bot\_id** `string` *required*
>
> WhatsApp Business Bot ID, provided when the bot is created and available in Business Manager or through bot management APIs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get WhatsApp Business Compliance Info
>
> **Slug:** `WHATSAPP_GET_BUSINESS_COMPLIANCE_INFO`
>
> Retrieve comprehensive business compliance information for a WhatsApp Business phone number. Returns regulatory and compliance details including entity registration status, grievance officer contact information, and customer care details. Use this action to verify business compliance status, review registered business information, and ensure proper contact details are configured for regulatory requirements. Use when you need to check business registration status, review grievance officer details for legal compliance, or verify customer care contact information for your WhatsApp Business account.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated list of fields to retrieve. Available fields: messaging\_product, entity\_name, entity\_type, entity\_type\_custom, is\_registered, grievance\_officer\_details, customer\_care\_details, whatsapp\_business\_account\_id. If not specified, returns all default fields.
>
> **phone\_number\_id** `string` *required*
>
> The WhatsApp Business phone number ID (e.g., '1234567890123456'). Get this from the WHATSAPP\_GET\_PHONE\_NUMBERS action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Business Encryption
>
> **Slug:** `WHATSAPP_GET_BUSINESS_ENCRYPTION`
>
> Retrieve the WhatsApp Business public key and its signature verification status. Use this action when you need to obtain the end-to-end encryption public key for a WhatsApp Business phone number. This is useful for setting up secure messaging integrations and verifying the authenticity of messages. The response includes the base64-encoded public key and its signature status.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated list of fields to include in the response. Available fields: business\_public\_key, business\_public\_key\_signature\_status. Default includes both fields.
>
> **phone\_number\_id** `string` *required*
>
> Your WhatsApp Business phone number ID. This ID represents the phone number entity and can be obtained from your WhatsApp Business Account phone numbers list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get business portfolio
>
> **Slug:** `WHATSAPP_GET_BUSINESS_PORTFOLIO`
>
> Retrieve a Meta business portfolio's ID, name and timezone identifier. Supply a business portfolio ID from Meta Business Suite business settings. Optional fields selects the returned information. This reads the portfolio itself, rather than its WhatsApp Business Accounts or phone numbers.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated fields to return, for example id,name,timezone\_id. Omit to use the provider's default field selection.
>
> **business\_id** `string` *required*
>
> Business portfolio ID, found in Meta Business Suite business settings. Use the portfolio ID, not a WhatsApp Business Account or phone number ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get business profile
>
> **Slug:** `WHATSAPP_GET_BUSINESS_PROFILE`
>
> Get the business profile information for a WhatsApp Business phone number. This includes business details like description, address, website, and contact info.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated list of fields to retrieve. Default includes all available fields.
>
> **phone\_number\_id** `string` *required*
>
> The phone number ID to get the business profile for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get business profile node
>
> **Slug:** `WHATSAPP_GET_BUSINESS_PROFILE_NODE`
>
> Retrieve a WhatsApp Business Profile node by its profile ID. Returns the profile object directly, including its ID and selected business information. This is GET /\{profile-id}, distinct from WHATSAPP\_GET\_BUSINESS\_PROFILE, which reads the /whatsapp\_business\_profile edge of a phone number and extracts an entry from its data array.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated fields to retrieve: id,description,email,about,address,vertical,websites,profile\_picture\_url,verified\_name,messaging\_product. Omit for the provider's default fields.
>
> **whatsapp\_business\_profile\_id** `string` *required*
>
> WhatsApp Business Profile node ID, found in WhatsApp Business Manager or through business management APIs. Supply the profile ID, not a phone number ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get call permissions
>
> **Slug:** `WHATSAPP_GET_CALL_PERMISSIONS`
>
> Check permission to call one WhatsApp user from a business phone number. Identify the user by phone number or BSUID. Returns their permission state and available calling/permission-request actions with rate limits. Calling must be enabled on the business phone number. This does not request permission or call.
>
> #### Input Parameters
>
> **recipient** `string`
>
> User's business-scoped user ID (BSUID) or parent BSUID, obtained from messaging webhooks. Can identify the user instead of user\_wa\_id.
>
> **user\_wa\_id** `string`
>
> WhatsApp user's phone number in international format, obtained from your customer or messaging webhook. Required unless recipient is provided.
>
> **phone\_number\_id** `string` *required*
>
> Business phone number ID. Discover it with WHATSAPP\_GET\_PHONE\_NUMBERS; this is not the display phone number.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get client WhatsApp Business Accounts
>
> **Slug:** `WHATSAPP_GET_CLIENT_BUSINESS_ACCOUNTS`
>
> Retrieve WhatsApp Business Accounts shared with or managed by a business portfolio. Use this action when you need to get WhatsApp Business Accounts (WABAs) that are client accounts shared with or managed by a specific business portfolio, as opposed to accounts directly owned by that business. This is useful for agencies managing accounts for multiple clients, or for businesses accessing accounts shared with them. The action supports filtering by business type, pagination with cursors, finding specific accounts by ID, and specifying which fields to return.
>
> #### Input Parameters
>
> **find** `string`
>
> Find a specific WhatsApp Business Account by ID.
>
> **after** `string`
>
> Cursor for forward pagination. Use the cursor from the previous response to get the next page of results.
>
> **limit** `integer`
>
> Maximum number of WhatsApp Business Accounts to return per page. Default is 25, maximum is 100.
>
> **before** `string`
>
> Cursor for backward pagination. Use the cursor from the previous response to get the previous page of results.
>
> **fields** `string`
>
> Comma-separated list of fields to include in the response. Available fields: id, name, account\_review\_status, purchase\_order\_number, audiences, ownership\_type, subscribed\_apps, business\_verification\_status, country, currency, timezone\_id, on\_behalf\_of\_business\_info, schedules, is\_enabled\_for\_insights, dcc\_config, message\_templates, phone\_numbers.
>
> **business\_id** `string` *required*
>
> The Business ID representing the business portfolio whose client WhatsApp Business Accounts you want to retrieve. This can be found in your Meta Business Suite URL or through business management APIs.
>
> **business\_type** `array`
>
> Filter results by WhatsApp Business Account type (STANDARD or PREMIUM).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get WhatsApp Commerce Settings
>
> **Slug:** `WHATSAPP_GET_COMMERCE_SETTINGS`
>
> Get commerce settings for a WhatsApp Business phone number. Retrieves cart and catalog visibility settings for a specific WhatsApp Business phone number. Use this action to check whether shopping cart and product catalog features are enabled for customer interactions. This is useful for managing e-commerce capabilities on your WhatsApp Business account. Use when you need to verify the current commerce configuration of a phone number before enabling shopping features or displaying products to customers.
>
> #### Input Parameters
>
> **phone\_number\_id** `string` *required*
>
> The WhatsApp Business phone number ID (e.g., '527759822865714'). Get this from the WHATSAPP\_GET\_PHONE\_NUMBERS action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get connected client businesses
>
> **Slug:** `WHATSAPP_GET_CONNECTED_CLIENT_BUSINESSES`
>
> Retrieve one page of client businesses connected to a Meta application. Obtain the application ID from your Meta App Dashboard. Returns business IDs and names, with pagination cursors when available. Pass paging.cursors.after as after to fetch the next page, or paging.cursors.before as before to go back. This is application-level client discovery, not the caller's owned-WABA list; use WHATSAPP\_GET\_OWNED\_BUSINESS\_ACCOUNTS for that. The provider's app access rules determine which client businesses the connected credential can read.
>
> #### Input Parameters
>
> **after** `string`
>
> Next-page cursor from paging.cursors.after in a prior response.
>
> **limit** `integer`
>
> Maximum businesses per page (1–100). The provider defaults to 25 when omitted.
>
> **before** `string`
>
> Previous-page cursor from paging.cursors.before in a prior response.
>
> **fields** `string`
>
> Comma-separated fields to retrieve: id, name. When omitted, the provider returns id and name.
>
> **application\_id** `string` *required*
>
> Meta Application ID, found in your Meta App Dashboard when you create an application. This is an application ID, not a WhatsApp Business Account ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get extended credits
>
> **Slug:** `WHATSAPP_GET_EXTENDED_CREDITS`
>
> Retrieve one page of a Meta Business Portfolio's extended credit lines. Use this to discover credit line IDs, legal entities and requested balances before a credit-sharing workflow. Supply a Business Portfolio ID. Use the returned before/after cursors to navigate pages and fields to select details. Solution Partners need a system user token whose user has an Admin or Financial Editor role on the portfolio.
>
> #### Input Parameters
>
> **after** `string`
>
> Next-page cursor from paging.cursors.after.
>
> **limit** `integer`
>
> Requested number of credit lines per page.
>
> **before** `string`
>
> Previous-page cursor from paging.cursors.before.
>
> **fields** `string`
>
> Comma-separated response fields: id, credit\_type, balance, credit\_available, max\_balance, online\_max\_balance, allocated\_amount, partition\_from, owner\_business, owner\_business\_name, is\_automated\_experience, legal\_entity\_name, send\_bill\_to\_biz\_name, liable\_biz\_name, receiving\_credit\_allocation\_config, is\_access\_revoked, is\_shared\_credit\_line\_enabled\_for\_mpa. Omit for provider defaults.
>
> **business\_id** `string` *required*
>
> Meta Business Portfolio ID, not a WhatsApp Business Account ID. Find it in Meta Business Suite > Business Settings > Business Info, or with WHATSAPP\_GET\_BUSINESS\_PORTFOLIO.
>
> **order\_by\_is\_owned\_credential** `boolean`
>
> When true, order owning credentials before receiving credentials.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get flow
>
> **Slug:** `WHATSAPP_GET_FLOW`
>
> Get one WhatsApp Flow's metadata, validation errors, preview, or health. Supply a Flow ID from creation or the owning account's Flow listing. Omit fields for the provider's default metadata, or select fields and expressions to retrieve a preview link or check health for a specific business number. This read operation can also mutate preview links: if the caller requests preview\.invalidate(true), it generates a new link and invalidates the previous one. Preview links are shareable without login.
>
> #### Input Parameters
>
> **fields** `string`
>
> Graph API fields expression. Omit to return id, name, status, categories, and validation\_errors. Available fields: id, name, categories, preview, status, validation\_errors, json\_version, data\_api\_version, endpoint\_uri, whatsapp\_business\_account, application, health\_status. Use preview\.invalidate(false) to retrieve a preview link without invalidating the existing one; preview\.invalidate(true) generates a new link and invalidates the old one. Use health\_status.phone\_number(PHONE\_NUMBER\_ID) to check health for a specific business phone number. Combine expressions with commas. Legacy data\_channel\_uri is deprecated since Graph API v19.0; use endpoint\_uri instead.
>
> **flow\_id** `string` *required*
>
> Flow ID returned when creating a Flow, or obtained by listing Flows for the owning WhatsApp Business Account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Flow Assets
>
> **Slug:** `WHATSAPP_GET_FLOW_ASSETS`
>
> List assets associated with a WhatsApp Flow. Use this action when you need to retrieve the assets (such as flow\.json) that are associated with a WhatsApp Flow. The response includes download URLs for each asset that can be used to fetch the actual content. Note: The download URLs are typically valid for a limited time period and should be used promptly after retrieval.
>
> #### Input Parameters
>
> **flow\_id** `string` *required*
>
> The unique identifier of the flow. This is the ID assigned by Meta when the flow is created.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get group
>
> **Slug:** `WHATSAPP_GET_GROUP`
>
> Retrieve metadata about one WhatsApp group by its group ID. Use fields to select group settings, participants, and participant count. Omitting fields leaves the provider's minimal default response unchanged.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated fields to return: id, messaging\_product, join\_approval\_mode, subject, description, suspended, creation\_timestamp, participants, total\_participant\_count. Omit to use the provider's minimal default response.
>
> **group\_id** `string` *required*
>
> Group ID obtained from group creation, a group lifecycle webhook, or the active groups listing for your business phone number.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Join Requests
>
> **Slug:** `WHATSAPP_GET_JOIN_REQUESTS`
>
> Retrieve pending join requests for a WhatsApp group to help manage group membership. Results support before and after cursor pagination, with a page size of 1–100 requests.
>
> #### Input Parameters
>
> **after** `string`
>
> Cursor that points to the end of a page of data to retrieve the next page of results. Use the 'after' cursor from the previous response's paging.cursors.
>
> **limit** `integer`
>
> Maximum number of join requests to return per page (1-100).
>
> **before** `string`
>
> Cursor that points to the beginning of a page of data to retrieve the previous page of results. Use the 'before' cursor from the previous response's paging.cursors.
>
> **group\_id** `string` *required*
>
> The unique ID of the WhatsApp group to retrieve join requests for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get max price agreements
>
> **Slug:** `WHATSAPP_GET_MAX_PRICE_AGREEMENTS`
>
> Check the max price beta agreement status for a Meta business portfolio. Returns none, pending, or accepted and the signer details when present. Use this to check enrollment in the Marketing Messages API max price beta. The agreement is signed once per Meta Business Suite, including for Solution Partners managing eligible clients. This read does not send an agreement email.
>
> #### Input Parameters
>
> **business\_id** `string` *required*
>
> Meta Business Suite (business portfolio) ID. Find it in Meta Business Suite business settings; this is not a WhatsApp Business Account or phone number ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get media info
>
> **Slug:** `WHATSAPP_GET_MEDIA_INFO`
>
> Get metadata and download URL for uploaded WhatsApp media. Returns media ID, download URL (valid for 5 minutes), MIME type, SHA256 hash, and file size. The download URL can be used to retrieve the actual media file.
>
> #### Input Parameters
>
> **media\_id** `string` *required*
>
> The WhatsApp media ID to retrieve information for (obtained from media upload or webhook notifications).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get WhatsApp Message History
>
> **Slug:** `WHATSAPP_GET_MESSAGE_HISTORY`
>
> Retrieve message history for a WhatsApp Business phone number. Returns a paginated list of messages with their delivery status information, including events like delivery status updates, timestamps, and webhook information. Use this action when you need to track message delivery status, audit message history, or retrieve detailed information about specific messages. Use when you want to check if messages were delivered, track message status changes, or retrieve delivery receipts for WhatsApp Business messages.
>
> #### Input Parameters
>
> **after** `string`
>
> Cursor for pagination. Use this to get the next page of results. This value comes from the 'paging.cursors.after' field in previous responses.
>
> **limit** `integer`
>
> Maximum number of message history entries to return per page. Default is 25, maximum is 100.
>
> **before** `string`
>
> Cursor for pagination. Use this to get the previous page of results. This value comes from the 'paging.cursors.before' field in previous responses.
>
> **fields** `string`
>
> Comma-separated list of fields to include in the response. If not specified, default fields will be returned (id, message\_id). Available fields: id, message\_id, events\{delivery\_status,webhook\_update\_state,timestamp,application,webhook\_uri,error\_description}
>
> **message\_id** `string`
>
> Filter results by a specific WhatsApp message ID (WAMID). When provided, only message history for this specific message will be returned.
>
> **phone\_number\_id** `string` *required*
>
> The WhatsApp Business phone number ID. This is the ID associated with your registered phone number in WhatsApp Business Manager.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get message history events
>
> **Slug:** `WHATSAPP_GET_MESSAGE_HISTORY_EVENTS`
>
> Retrieve one page of delivery status events for a Message History ID. Obtain the entry ID from message history APIs, then inspect status transitions, occurrence timestamps, application details, or webhook updates. Use the returned before/after cursors to request additional pages.
>
> #### Input Parameters
>
> **after** `string`
>
> Next-page cursor from paging.cursors.after.
>
> **limit** `integer`
>
> Events per page; provider default is 25, maximum 100.
>
> **before** `string`
>
> Previous-page cursor from paging.cursors.before.
>
> **fields** `string`
>
> Comma-separated Graph fields. Available: cursor, node\{id,delivery\_status,error\_description,occurrence\_timestamp,status\_timestamp,application,webhook\_update\_state,webhook\_uri}. Defaults to cursor,node\{id,delivery\_status,occurrence\_timestamp} when omitted.
>
> **delivery\_status** `string ("ACCEPTED" | "DELIVERED" | "ERROR" | "READ" | "SENT")`
>
> Return only events with this delivery status.
>
> **message\_history\_id** `string` *required*
>
> Message History ID obtained from message history APIs (the entry's id, not a phone number ID or message WAMID).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get message templates
>
> **Slug:** `WHATSAPP_GET_MESSAGE_TEMPLATES`
>
> Get all message templates for the WhatsApp Business Account. Templates are required for sending messages outside the 24-hour window and for marketing/utility messages.
>
> #### Input Parameters
>
> **after** `string`
>
> Cursor for pagination to get templates after this cursor.
>
> **limit** `integer`
>
> The maximum number of templates to retrieve. Default is 25.
>
> **fields** `string`
>
> Optional comma-separated list of template fields to include in the response (e.g. 'name,status,category,language,components'). If omitted, the API returns its default set of fields.
>
> **status** `string`
>
> Filter by template status: APPROVED, PENDING, REJECTED, DISABLED, PAUSED, LIMIT\_EXCEEDED.
>
> **waba\_id** `string`
>
> Optional: WhatsApp Business Account ID to query. If not provided, uses the waba\_id from your connection configuration. Only provide this if you need to override the configured WABA ID.
>
> **category** `string`
>
> Filter by template category: AUTHENTICATION, MARKETING, UTILITY.
>
> **language** `string`
>
> Filter by language code (e.g., 'en\_US', 'es\_ES').
>
> **name\_or\_content** `string`
>
> Filter templates by name or content substring.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get migration intent
>
> **Slug:** `WHATSAPP_GET_MIGRATION_INTENT`
>
> Retrieve a WhatsApp Business Account migration intent's status and linked accounts. Use the ID obtained when creating the migration intent to monitor its lifecycle, check migration progress, or inspect its source, destination, and solution.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated response fields: id, status, destination\_waba, solution, waba. Omit to use provider defaults (solution, status, destination\_waba).
>
> **migration\_intent\_id** `string` *required*
>
> Migration intent ID returned when creating the migration intent; discover it through migration management APIs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get official business account status
>
> **Slug:** `WHATSAPP_GET_OFFICIAL_BUSINESS_ACCOUNT_STATUS`
>
> Retrieve Official Business Account (OBA) application status for a business phone number. Use this to monitor verification progress or read its status message. Obtain the phone number ID from WHATSAPP\_GET\_PHONE\_NUMBERS. This only reads status; it does not submit an OBA application.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated response fields: oba\_status, status\_message. Omit to request the provider's default fields (oba\_status, status\_message).
>
> **phone\_number\_id** `string` *required*
>
> WhatsApp Business phone number ID. Obtain it using WHATSAPP\_GET\_PHONE\_NUMBERS; this is not the display phone number or WABA ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get owned WhatsApp Business Accounts
>
> **Slug:** `WHATSAPP_GET_OWNED_BUSINESS_ACCOUNTS`
>
> Retrieve WhatsApp Business Accounts owned by a business portfolio. Use this action when you need to get all WhatsApp Business Accounts (WABAs) that are directly owned by a specific business. This differs from client accounts which are shared with the business. This is useful for managing your own accounts, querying their details, and navigating through paginated results. The action supports filtering by business type, pagination with cursors, finding specific accounts by ID, and specifying which fields to return.
>
> #### Input Parameters
>
> **find** `string`
>
> Find a specific WhatsApp Business Account by ID within the owned accounts. Use this to quickly locate a specific account.
>
> **last** `integer`
>
> Number of results to return in backward pagination. Maximum value is 100. Use with 'before' cursor for backward pagination.
>
> **after** `string`
>
> Cursor for forward pagination. Use the cursor from the previous response to get the next page of results.
>
> **first** `integer`
>
> Number of results to return in forward pagination. Maximum value is 100. Use with 'after' cursor for forward pagination.
>
> **before** `string`
>
> Cursor for backward pagination. Use the cursor from the previous response to get the previous page of results.
>
> **fields** `string`
>
> Comma-separated list of fields to include in the response. Available fields: id, name, account\_review\_status, purchase\_order\_number, audiences, ownership\_type, subscribed\_apps, business\_verification\_status, country, currency, timezone\_id, on\_behalf\_of\_business\_info, schedules, is\_enabled\_for\_insights, dcc\_config, message\_templates, phone\_numbers.
>
> **business\_id** `string` *required*
>
> The Business ID representing the business portfolio that owns the WhatsApp Business Accounts. This can be found in your Business Manager settings.
>
> **business\_type** `array`
>
> Filter accounts by business type. Can specify multiple types like ENTERPRISE or SMB to filter between enterprise and small-medium business accounts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get phone number
>
> **Slug:** `WHATSAPP_GET_PHONE_NUMBER`
>
> Retrieve detailed information about a specific WhatsApp Business phone number. Returns phone number details including verification status, quality rating, display number, verified business name, throughput limits, and webhook configuration. Use this to check phone number status, settings, and capabilities. To get available phone number IDs, first call WHATSAPP\_GET\_PHONE\_NUMBERS.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated list of fields to retrieve. Available fields: id, display\_phone\_number, verified\_name, code\_verification\_status, quality\_rating, platform\_type, throughput, webhook\_configuration, last\_onboarded\_time. Default retrieves all available fields.
>
> **phone\_number\_id** `string` *required*
>
> The WhatsApp Business phone number ID (e.g., '901139066420489'). Get this from the WHATSAPP\_GET\_PHONE\_NUMBERS action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get phone numbers
>
> **Slug:** `WHATSAPP_GET_PHONE_NUMBERS`
>
> Retrieve a page of phone numbers registered to the connection's WhatsApp Business Account. Results can include phone number IDs, display numbers, verification status, quality ratings, throughput limits, and paging information.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of phone numbers to return per page (1-100). Use lower values for faster responses or when you only need a few numbers.
>
> **waba\_id** `string`
>
> Optional: WhatsApp Business Account ID to query. If not provided, uses the waba\_id from your connection configuration. Only provide this if you need to override the configured WABA ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get preverified number
>
> **Slug:** `WHATSAPP_GET_PREVERIFIED_NUMBER`
>
> Retrieve a pre-verified phone number's verification status, owner, and expiry. Supply the pre-verified number ID from your Business Solution Provider or WHATSAPP\_LIST\_PREVERIFIED\_NUMBERS. Optionally select response fields.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated response fields: id, code\_verification\_status, code\_verification\_time, owner\_business, phone\_number, verification\_expiry\_time. Omit to use provider defaults.
>
> **preverified\_phone\_number\_id** `string` *required*
>
> Pre-verified phone number ID provided by your Business Solution Provider during pre-verification, or discovered through WHATSAPP\_LIST\_PREVERIFIED\_NUMBERS.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get preverified number partners
>
> **Slug:** `WHATSAPP_GET_PREVERIFIED_NUMBER_PARTNERS`
>
> List partner businesses with access to a pre-verified WhatsApp phone number. Returns one page of Business nodes, with id and name by default. Select additional Business fields with fields; use before or after to navigate pages.
>
> #### Input Parameters
>
> **after** `string`
>
> Next-page cursor from paging.cursors.after.
>
> **limit** `integer`
>
> Maximum partner businesses per page (1–100). The provider defaults to 25 when omitted.
>
> **before** `string`
>
> Previous-page cursor from paging.cursors.before.
>
> **fields** `string`
>
> Comma-separated Business node fields to retrieve. The provider defaults to id,name when omitted.
>
> **pre\_verified\_phone\_number\_id** `string` *required*
>
> Pre-verified phone number ID, provided when created or found in WhatsApp Business Account management. This is not the phone number itself.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get qr code
>
> **Slug:** `WHATSAPP_GET_QR_CODE`
>
> Retrieve one message QR code by phone number ID and QR code identifier. Returns its code, pre-filled message and deep link in a data array. Request qr\_image\_url.format(SVG) or qr\_image\_url.format(PNG) in fields for an image URL. Use WHATSAPP\_LIST\_QR\_CODES to discover existing QR code identifiers.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated fields to retrieve: code, prefilled\_message, deep\_link\_url (always included), creation\_time (first-party apps only), and qr\_image\_url.format(SVG) or qr\_image\_url.format(PNG). For example: code,prefilled\_message,qr\_image\_url.format(SVG).
>
> **qr\_code\_id** `string` *required*
>
> The QR code's unique 14-character identifier. Use the code returned by WHATSAPP\_CREATE\_QR\_CODE or WHATSAPP\_LIST\_QR\_CODES.
>
> **phone\_number\_id** `string` *required*
>
> WhatsApp Business phone number ID that owns the QR code. Obtain it from WHATSAPP\_GET\_PHONE\_NUMBERS.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get reach estimate
>
> **Slug:** `WHATSAPP_GET_REACH_ESTIMATE`
>
> Estimate WhatsApp marketing message reach and costs at different max prices. Reads historical estimates for a Messaging account onboarded to the Marketing Messages API in an eligible country. This beta planning tool returns delivery and cost ranges, not guarantees of future performance. Supply geographic targeting and a historical lookback; this does not send messages.
>
> #### Input Parameters
>
> **waba\_id** `string` *required*
>
> WhatsApp Business Account (Messaging account) ID. Find it in WhatsApp Manager or list accounts with WHATSAPP\_LIST\_BUSINESS\_ACCOUNTS; do not use a phone number ID.
>
> **date\_interval** `string ("L1D" | "L7D" | "L14D" | "L28D")` *required*
>
> Historical lookback for estimates: L1D (1 day), L7D (7 days), L14D (14 days), or L28D (28 days).
>
> **targeting\_spec** `object` *required*
>
> Required geographic targeting, shaped as \{'geo\_locations': \{'countries': \['IN']}}. Serialized to JSON in the query.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get WhatsApp Schedules
>
> **Slug:** `WHATSAPP_GET_SCHEDULES`
>
> Retrieve campaign schedules for the WhatsApp Business Account configured on the connection. Results are paginated and can include status, timing, and recurrence information.
>
> #### Input Parameters
>
> **sort** `string ("created_time.asc" | "created_time.desc" | "updated_time.asc" | "updated_time.desc")`
>
> Sort options for schedule results.
>
> **after** `string`
>
> Cursor for pagination - retrieve records after this cursor.
>
> **limit** `integer`
>
> Maximum number of schedules to return per page.
>
> **before** `string`
>
> Cursor for pagination - retrieve records before this cursor.
>
> **fields** `string`
>
> Comma-separated list of fields to include in the response. Available fields: id, name, status, schedule\_type, description, start\_time, end\_time, timezone, days\_of\_week, created\_time, updated\_time, is\_active, recurrence\_pattern. Defaults to 'id,name,status,schedule\_type'.
>
> **waba\_id** `string`
>
> Optional: WhatsApp Business Account ID to query. If not provided, uses the waba\_id from your connection configuration.
>
> **filtering** `string`
>
> JSON-encoded array of filter conditions. Each filter should specify field, operator, and value. Supported fields: status, schedule\_type, is\_active. Example: \[\{"field":"status","operator":"EQUAL","value":"ACTIVE"}]
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get WhatsApp Cloud API Settings
>
> **Slug:** `WHATSAPP_GET_SETTINGS`
>
> Get Cloud API settings for a WhatsApp Business phone number. Retrieves calling, storage, and payload encryption settings for a specific WhatsApp Business phone number. This includes information about call features, IP addresses for calling, data storage preferences, and encryption settings. Use this action to check the current configuration and capabilities of a phone number's Cloud API integration. Use when you need to verify the current Cloud API settings for a phone number, including calling features, encryption status, and data storage configuration.
>
> #### Input Parameters
>
> **phone\_number\_id** `string` *required*
>
> The WhatsApp Business phone number ID (e.g., '712594308615206'). Get this from the WHATSAPP\_GET\_PHONE\_NUMBERS action.
>
> **include\_sip\_credentials** `boolean`
>
> Include SIP credentials in the response. Requires additional permissions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get solution access token
>
> **Slug:** `WHATSAPP_GET_SOLUTION_ACCESS_TOKEN`
>
> Retrieve an onboarded client's business integration system user access token. Returns a SENSITIVE CREDENTIAL, not ordinary account information. Use only for an authorized solution partner/admin retrieving a token for a customer who shared a WABA with that Multi-Partner Solution through Embedded Signup. Supply the explicit solution ID and customer's business portfolio ID from account\_update; authenticate with the partner's authorized system user token. Meta enforces partner and asset authorization. This does not retrieve the connection's authentication token or grant access to arbitrary businesses. Store the returned client token securely and never log or disclose it.
>
> #### Input Parameters
>
> **business\_id** `string` *required*
>
> Explicit onboarded customer's Business Portfolio ID from account\_update.owner\_business\_id. The customer must have shared a WhatsApp Business Account with this solution.
>
> **solution\_id** `string` *required*
>
> Your authorized Multi-Partner Solution ID from the Partner Dashboard or account\_update webhook; not a WABA ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Subscribed Apps
>
> **Slug:** `WHATSAPP_GET_SUBSCRIBED_APPS`
>
> Get all applications currently subscribed to webhooks for a WhatsApp Business Account. Use this action when you need to retrieve the list of third-party applications or integrations that are subscribed to receive webhook events for a specific WABA.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated list of fields to include in the response. Available fields: id, name, link.
>
> **waba\_id** `string`
>
> Optional: WhatsApp Business Account ID to query. If not provided, uses the waba\_id from your connection configuration. Only provide this if you need to override the configured WABA ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get message template library
>
> **Slug:** `WHATSAPP_GET_TEMPLATE_LIBRARY`
>
> Browse the pre-built message template library for WhatsApp Business Account. This retrieves a list of available templates that can be used for messaging. Use when you need to discover available message templates for sending marketing, utility, or authentication messages to WhatsApp users.
>
> #### Input Parameters
>
> **after** `string`
>
> Cursor for pagination to get templates after this cursor.
>
> **limit** `integer`
>
> The maximum number of templates to retrieve. Default is 25.
>
> **status** `string`
>
> Filter by template status: APPROVED, PENDING, REJECTED, DISABLED, PAUSED, LIMIT\_EXCEEDED.
>
> **country** `string`
>
> Filter by country code (e.g., 'US', 'GB').
>
> **category** `string`
>
> Filter by template category: AUTHENTICATION, MARKETING, UTILITY.
>
> **language** `string`
>
> Filter by language code (e.g., 'en\_US', 'es\_ES').
>
> **name\_or\_content** `string`
>
> Filter templates by name or content substring.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get template status
>
> **Slug:** `WHATSAPP_GET_TEMPLATE_STATUS`
>
> Get the status and details of a specific message template. This is useful for checking if a template has been approved, rejected, or is still pending review.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated list of fields to retrieve. Valid fields include: id, name, status, category, language, components, previous\_category, parameter\_format, quality\_score, rejected\_reason. If not specified, returns all default fields.
>
> **template\_id** `string` *required*
>
> The ID of the template to check the status for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get upload offset
>
> **Slug:** `WHATSAPP_GET_UPLOAD_OFFSET`
>
> Get the byte offset of an interrupted resumable upload. Use the session ID returned by WHATSAPP\_CREATE\_UPLOAD\_SESSION, then pass the returned file\_offset and remaining bytes to WHATSAPP\_UPLOAD\_FILE\_CHUNK. The Resumable Upload API requires a user access token in the auth header.
>
> #### Input Parameters
>
> **upload\_session\_id** `string` *required*
>
> Session ID returned by WHATSAPP\_CREATE\_UPLOAD\_SESSION. Pass the returned id, including upload: and any ?sig= signature, unchanged; a bare session ID is also accepted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List blocked users
>
> **Slug:** `WHATSAPP_LIST_BLOCKED_USERS`
>
> Retrieve one page of blocked users for a WhatsApp Business phone number. Returns data entries with messaging\_product and wa\_id, plus paging.cursors. Pass the returned after or before cursor to retrieve another page.
>
> #### Input Parameters
>
> **after** `string`
>
> Forward pagination cursor from paging.cursors.after.
>
> **limit** `integer`
>
> Maximum number of blocked users to return in this page.
>
> **before** `string`
>
> Backward pagination cursor from paging.cursors.before.
>
> **phone\_number\_id** `string` *required*
>
> WhatsApp Business phone number ID. Discover it with WHATSAPP\_GET\_PHONE\_NUMBERS.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List business accounts
>
> **Slug:** `WHATSAPP_LIST_BUSINESS_ACCOUNTS`
>
> List WhatsApp Business Accounts owned by a business portfolio. Uses Meta's owned\_whatsapp\_business\_accounts edge, the same owned-account resource as WHATSAPP\_GET\_OWNED\_BUSINESS\_ACCOUNTS. For accounts shared by other businesses, use WHATSAPP\_GET\_CLIENT\_BUSINESS\_ACCOUNTS instead. Use its business\_type/find filters and limit/after/before pagination to return one page. Authenticate with a credential authorized to read this portfolio.
>
> #### Input Parameters
>
> **find** `string`
>
> Find a specific owned WABA by its ID from an account listing.
>
> **after** `string`
>
> Next-page cursor from paging.cursors.after.
>
> **limit** `integer`
>
> Accounts per page (1–100); provider default: 25.
>
> **before** `string`
>
> Previous-page cursor from paging.cursors.before.
>
> **fields** `string`
>
> Comma-separated response fields: id, name, account\_review\_status, purchase\_order\_number, currency, timezone\_id, business\_verification\_status, country, on\_behalf\_of\_business\_info, is\_enabled\_for\_insights, message\_template\_namespace. Provider defaults: id,name,currency,timezone\_id.
>
> **business\_id** `string` *required*
>
> Business portfolio ID, found in Meta Business Suite or through business management APIs.
>
> **business\_type** `array`
>
> Filter by WhatsApp Business Account types.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List business solutions
>
> **Slug:** `WHATSAPP_LIST_BUSINESS_SOLUTIONS`
>
> List one page of Multi-Partner Solutions owned by or partnered with a Meta app. Use an Application ID from the App Dashboard and optionally filter by OWNER or PARTNER. Continue with returned paging cursors. This application-level listing differs from WHATSAPP\_LIST\_SOLUTIONS, which lists solutions that onboarded a WABA. Partner eligibility and access to the application are required by Meta.
>
> #### Input Parameters
>
> **role** `string ("OWNER" | "PARTNER")`
>
> Filter by the application's relationship to the solution. Omit to include both owned and partnered solutions.
>
> **after** `string`
>
> Next-page cursor from paging.cursors.after.
>
> **limit** `integer`
>
> Solutions per page (1–100); provider default: 25.
>
> **before** `string`
>
> Previous-page cursor from paging.cursors.before.
>
> **fields** `string`
>
> Comma-separated fields: id, name, status, status\_for\_pending\_request, owner\_app, owner\_permissions. Provider defaults: name,status,status\_for\_pending\_request.
>
> **application\_id** `string` *required*
>
> Meta Application ID from the App Dashboard. Use an application ID, not a WhatsApp Business Account (WABA) ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List WhatsApp Flows
>
> **Slug:** `WHATSAPP_LIST_FLOWS`
>
> List all WhatsApp Flows associated with the WhatsApp Business Account. Returns flow details including name, status, categories, and any validation errors. Use when you need to retrieve all available flows to select one for messaging or to check the status of existing flows.
>
> #### Input Parameters
>
> **after** `string`
>
> Cursor for pagination to get flows after this cursor.
>
> **limit** `integer`
>
> The maximum number of flows to retrieve per page (1-100). Default is 25. Use lower values for faster responses.
>
> **waba\_id** `string`
>
> Optional: WhatsApp Business Account ID to query. If not provided, uses the waba\_id from your connection configuration. Only provide this if you need to override the configured WABA ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List WhatsApp Groups
>
> **Slug:** `WHATSAPP_LIST_GROUPS`
>
> List all WhatsApp groups associated with a business phone number. Use this action when you need to retrieve the list of groups that a business phone number is a member of. This is useful for managing group memberships, sending messages to groups, or auditing group participation. Results can be paginated using the 'after' and 'before' cursors from the paging response.
>
> #### Input Parameters
>
> **after** `string`
>
> Cursor that points to the end of a page of data to retrieve the next page of results. Use the 'after' cursor from the previous response's paging.cursors.
>
> **limit** `integer`
>
> Maximum number of groups to return per page (1-100). Use lower values for faster responses or when you only need a few groups.
>
> **before** `string`
>
> Cursor that points to the beginning of a page of data to retrieve the previous page of results. Use the 'before' cursor from the previous response's paging.cursors.
>
> **phone\_number\_id** `string` *required*
>
> The Meta-assigned numeric ID for the WhatsApp Business phone number. This is NOT the actual phone number itself - it is a numeric ID (e.g., '712594308615206') assigned by Meta. Obtain it using WHATSAPP\_GET\_PHONE\_NUMBERS action which returns the 'id' field for each phone number.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List on behalf requests
>
> **Slug:** `WHATSAPP_LIST_ON_BEHALF_REQUESTS`
>
> List one page of in-progress on-behalf requests for a WhatsApp Business Account. Returns pending business relationship requests and optionally the receiving and requesting businesses. Continue using the returned before/after cursors. The legacy On-Behalf-Of (OBO) ownership model was replaced by partner-initiated account creation: client transfers were due October 1, 2025, with eligible accounts scheduled for batch migration through the end of 2025. This model retirement does not establish removal of this operation; the v23 reference does not mark the operation deprecated. Access requires an authorized partner principal and an accessible WABA with relevant OBO requests.
>
> #### Input Parameters
>
> **after** `string`
>
> Forward pagination cursor from paging.cursors.after.
>
> **limit** `integer`
>
> Results per page (1–100); provider default: 25.
>
> **before** `string`
>
> Backward pagination cursor from paging.cursors.before.
>
> **fields** `string`
>
> Comma-separated fields: id, status, business\_owned\_object, receiving\_business, requesting\_business. Provider defaults: id,status,business\_owned\_object.
>
> **waba\_id** `string` *required*
>
> WhatsApp Business Account ID from WhatsApp Business Manager or the account listing APIs; not a phone number ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List preverified numbers
>
> **Slug:** `WHATSAPP_LIST_PREVERIFIED_NUMBERS`
>
> List pre-verified phone numbers available to a business portfolio. Optionally filter by phone number or verification status and select response fields. Returns one page; pass the returned before or after cursor to navigate pages.
>
> #### Input Parameters
>
> **after** `string`
>
> Next-page cursor from a previous response's paging.cursors.after.
>
> **limit** `integer`
>
> Maximum number of phone numbers to return per page.
>
> **before** `string`
>
> Previous-page cursor from a previous response's paging.cursors.before.
>
> **fields** `string`
>
> Comma-separated response fields: id, code\_verification\_status, code\_verification\_time, owner\_business, phone\_number, verification\_expiry\_time.
>
> **business\_id** `string` *required*
>
> Business portfolio ID. Find it in Meta Business Manager or through business management APIs.
>
> **phone\_number** `string`
>
> Return only pre-verified numbers matching this phone number.
>
> **code\_verification\_status** `string ("EXPIRED" | "NOT_VERIFIED" | "VERIFIED")`
>
> Filter numbers by verification status.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List qr codes
>
> **Slug:** `WHATSAPP_LIST_QR_CODES`
>
> Get a list of all QR codes for a WhatsApp Business phone number. Use this action when you need to retrieve all message QR codes associated with a specific WhatsApp Business phone number. This is useful for managing existing QR codes, checking their status, or obtaining their image URLs for display. The action supports pagination through the 'after' and 'before' parameters, and can filter results by a specific QR code ID.
>
> #### Input Parameters
>
> **code** `string`
>
> Filter results to a specific QR code by its unique identifier.
>
> **after** `string`
>
> Cursor for pagination. Use this to get the next page of results. Obtain this value from the paging.cursors.after field in previous responses.
>
> **limit** `integer`
>
> Maximum number of QR codes to return in a single response. Default is 25.
>
> **before** `string`
>
> Cursor for pagination. Use this to get the previous page of results. Obtain this value from the paging.cursors.before field in previous responses.
>
> **fields** `string`
>
> Comma-separated list of fields to include in the response. Available fields: code, prefilled\_message, deep\_link\_url, creation\_time (first-party apps only), qr\_image\_url.format(SVG|PNG). Example: 'code,prefilled\_message,deep\_link\_url,qr\_image\_url.format(SVG)'
>
> **phone\_number\_id** `string` *required*
>
> The WhatsApp Business Account phone number ID for which to list QR codes. This ID is provided when you add a phone number to your WhatsApp Business Account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List WhatsApp Solutions
>
> **Slug:** `WHATSAPP_LIST_SOLUTIONS`
>
> Retrieve a paginated list of Multi-Partner Solutions for the WhatsApp Business Account configured on the connection, including status and owner application information when returned.
>
> #### Input Parameters
>
> **after** `string`
>
> Cursor for pagination. Returns solutions after this cursor position. Use the cursor from the previous response's paging.cursors.after field.
>
> **limit** `integer`
>
> Maximum number of solutions to return per page (1-100). Default is 25.
>
> **before** `string`
>
> Cursor for pagination. Returns solutions before this cursor position. Use the cursor from the previous response's paging.cursors.before field.
>
> **fields** `string`
>
> Comma-separated list of fields to include in the response. If not specified, default fields will be returned (id, name, status, status\_for\_pending\_request). Available fields: id, name, status, status\_for\_pending\_request, owner\_app, owner\_permissions.
>
> **waba\_id** `string`
>
> Optional: WhatsApp Business Account ID to query. If not provided, uses the waba\_id from your connection configuration. Only provide this if you need to override the configured WABA ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Manage call
>
> **Slug:** `WHATSAPP_MANAGE_CALL`
>
> Initiate, pre-accept, accept, reject or terminate a WhatsApp WebRTC call. Calling must be enabled on the business number. Outbound connect requires the user's calling permission. Supply an SDP offer for connect or an SDP answer for pre\_accept/accept when sending a session. This sends signaling requests; the caller must operate a WebRTC media stack. Pre-accept establishes the media connection; start media only after accept returns 200 OK. Inbound calls must normally be accepted within 30–60 seconds of the Call Connect webhook.
>
> #### Input Parameters
>
> **to** `string`
>
> Callee phone number for connect; required unless recipient is supplied. Takes precedence over recipient.
>
> **action** `string ("connect" | "pre_accept" | "accept" | "reject" | "terminate")` *required*
>
> Call operation. connect starts an outbound call; other actions use call\_id.
>
> **call\_id** `string`
>
> Required except for connect. Get from the inbound Call Connect webhook or outbound connect response.
>
> **session** `object`
>
> Optional WebRTC SDP for connect (offer), pre\_accept or accept (answer). On accept, match any previously supplied pre\_accept answer.
>
> **recipient** `string`
>
> Callee BSUID or parent BSUID for connect, obtained from user/contact webhooks; alternative or addition to to.
>
> **recording** `object`
>
> Optional recording configuration for connect or accept, independent of transcription.
>
> **transcription** `object`
>
> Optional transcription configuration for connect or accept, independent of recording.
>
> **phone\_number\_id** `string` *required*
>
> Business phone number ID; discover with WHATSAPP\_GET\_PHONE\_NUMBERS.
>
> **messaging\_account\_id** `string`
>
> Messaging account ID from onboarding/account discovery. Include when the token has messaging access to multiple accounts on this number; keep the same value for every request for a call.
>
> **biz\_opaque\_callback\_data** `string`
>
> Optional tracking string for connect or accept, echoed in call webhooks.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Migrate flows
>
> **Slug:** `WHATSAPP_MIGRATE_FLOWS`
>
> Copy up to 100 Flows between WABAs owned by the same Meta business. Copies keep their names and published/draft state, and receive new IDs. Source Flows remain unchanged. A name already present in the destination fails for that Flow while other Flows can succeed; inspect failed\_flows even when the request succeeds. Omit source\_flow\_names to copy all source Flows, subject to the 100-Flow request limit.
>
> #### Input Parameters
>
> **source\_waba\_id** `string` *required*
>
> Source WhatsApp Business Account ID. Find it in Meta Business Settings > WhatsApp Accounts. Source Flows remain unchanged.
>
> **source\_flow\_names** `array`
>
> Names of source Flows to copy, as returned by WHATSAPP\_LIST\_FLOWS. Omit to copy all source Flows. Only 100 Flows can be migrated per request.
>
> **destination\_waba\_id** `string` *required*
>
> Destination WhatsApp Business Account ID. Find it in Meta Business Settings > WhatsApp Accounts. Must be owned by the same Meta business as the source account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Onboard marketing partners
>
> **Slug:** `WHATSAPP_ONBOARD_MARKETING_PARTNERS`
>
> Send a partner-initiated MM Lite onboarding request to an end business. Validates partner business and app permissions and end business eligibility, identifies eligible shared and on-behalf-of (OBO) WhatsApp Business Accounts, and creates a business agreement request. Business Solution Providers (BSPs) can create OBO WABAs and set mobility intents on eligible OBO WABAs; Technology Partners can only create onboarding requests, without OBO WABA management. Returns the existing request ID when the same partner and end business already have a pending request. Does not send a marketing message.
>
> #### Input Parameters
>
> **business\_id** `string` *required*
>
> End business portfolio ID that will receive the onboarding request, not the requesting partner's ID. Obtain it from the end business's Meta Business Suite business settings.
>
> **solution\_id** `string`
>
> Optional WhatsApp Business Solution ID from your partner solution configuration. Associates the solution with the business agreement and OBO mobility intents.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Publish WhatsApp Flow
>
> **Slug:** `WHATSAPP_PUBLISH_FLOW`
>
> Publish a WhatsApp Flow to make it available for use. Use this action when you have finished designing and testing a WhatsApp Flow and are ready to make it available for users. The flow must be in DRAFT status and pass all validation checks before it can be published. Note: Once published, the flow cannot be unpublished. To make changes, you will need to create a new version of the flow.
>
> #### Input Parameters
>
> **flow\_id** `string` *required*
>
> The unique identifier of the flow to publish. This is the ID assigned by Meta when the flow is created.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Register WhatsApp Business Phone Number
>
> **Slug:** `WHATSAPP_REGISTER_PHONE`
>
> Register a WhatsApp Business phone number for use with WhatsApp Cloud API. Use when you need to register a phone number that has been added to your WhatsApp Business Account. This action requires setting up a two-step verification PIN (6 digits) for the phone number. The phone number must be verified and properly configured in WhatsApp Manager before registration. Note: Registration is required before you can send messages from this phone number. Once registered, the phone number will be associated with your WhatsApp Business Account.
>
> #### Input Parameters
>
> **pin** `string` *required*
>
> 6-digit PIN for two-step verification setup. The PIN must be exactly 6 digits.
>
> **backup** `object`
>
> Backup data for migrating existing WhatsApp Business accounts.
>
> **phone\_number\_id** `string` *required*
>
> The ID of the phone number to register. This ID is provided when the phone number is added to your WhatsApp Business Account and can be found in WhatsApp Manager.
>
> **messaging\_product** `string`
>
> Must be 'whatsapp' to indicate WhatsApp Business messaging product.
>
> **data\_localization\_region** `string ("AE" | "AU" | "BH" | "BR" | "CA" | "CH" | "DE" | "GB" | "ID" | "IN" | "JP" | "KR" | "SG" | "ZA")`
>
> Data localization regions for message storage.
>
> **meta\_store\_retention\_minutes** `integer`
>
> Message retention period in minutes (deprecated in v21+). Only 60 minutes is allowed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Reject business solution
>
> **Slug:** `WHATSAPP_REJECT_BUSINESS_SOLUTION`
>
> Reject a pending partnership or deactivation request for a Multi-Partner Solution. Requires an eligible partner app with access to the solution. Partnership rejection requires the requesting partner's app ID. Rejection is permanent; rejected requests may need resubmission. An accepted partnership cannot be declined. Returns the rejection status and any available rejection details.
>
> #### Input Parameters
>
> **solution\_id** `string` *required*
>
> Multi-Partner Solution ID from App Dashboard > WhatsApp > Partner solutions, solution management APIs, or the partner\_solutions webhook's solution\_id.
>
> **request\_type** `string ("PARTNERSHIP_REQUEST" | "DEACTIVATION_REQUEST")` *required*
>
> Type of pending request to reject: a partnership invitation or a solution deactivation request.
>
> **partner\_app\_id** `string`
>
> Requesting partner's Meta app ID, obtained from the partner or solution details. Required for PARTNERSHIP\_REQUEST; not used for DEACTIVATION\_REQUEST.
>
> **rejection\_reason** `string`
>
> Optional reason for rejecting the request (at most 500 characters).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Reject group join requests
>
> **Slug:** `WHATSAPP_REJECT_GROUP_JOIN_REQUESTS`
>
> Reject pending requests to join a WhatsApp group, individually or in bulk. Requires a Groups API-eligible business number. Get join request IDs from the group's open join requests or group\_participants\_update webhooks. Rejected users see the Request to join button again on the invite link. HTTP 200 can include partial failures: inspect rejected\_join\_requests, failed\_join\_requests and errors before treating every rejection as successful.
>
> #### Input Parameters
>
> **group\_id** `string` *required*
>
> Group ID from group creation webhooks or the active groups listing.
>
> **join\_requests** `array` *required*
>
> Join request IDs to reject. Obtain IDs from the group's open join requests listing or group\_participants\_update webhooks.
>
> **messaging\_product** `string`
>
> Messaging product; must be whatsapp.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Reject solution deactivation
>
> **Slug:** `WHATSAPP_REJECT_SOLUTION_DEACTIVATION`
>
> Reject a pending Multi-Partner Solution deactivation request. Keeps the solution ACTIVE and clears PENDING\_DEACTIVATION to NONE, preserving its configuration, permissions, and ability to onboard clients. Partners are notified of the rejection. Requires an eligible solution partnership and a pending deactivation request; the multi-partner guide specifies solution-owner access. Returns solution state, optionally restricted by fields.
>
> #### Input Parameters
>
> **fields** `string`
>
> Comma-separated response fields: id, name, status, status\_for\_pending\_request, owner\_app, owner\_permissions. Omit for provider defaults: name,status,status\_for\_pending\_request.
>
> **solution\_id** `string` *required*
>
> Multi-Partner Solution ID with a pending deactivation request. Find it in WHATSAPP\_LIST\_BUSINESS\_SOLUTIONS, the App Dashboard's Partner solutions panel, or a partner\_solutions webhook's solution\_id.
>
> **reject\_deactivation\_request** `boolean` *required*
>
> Set to true to reject the pending deactivation request and keep the solution active.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove Assigned User from WhatsApp Business Account
>
> **Slug:** `WHATSAPP_REMOVE_ASSIGNED_USER`
>
> Remove an assigned user's access from the WhatsApp Business Account bound to the connection. The user must be reassigned to regain access.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> The user ID of the person to remove from the WhatsApp Business Account. This must be a valid Facebook user ID that is currently assigned to the account.
>
> **waba\_id** `string`
>
> Optional: WhatsApp Business Account ID to target. If not provided, uses the waba\_id from your connection configuration.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove group participants
>
> **Slug:** `WHATSAPP_REMOVE_GROUP_PARTICIPANTS`
>
> Request removal of one to eight WhatsApp group participants. Removed participants cannot rejoin via an invite link. Requires a Groups API-eligible business number and its whatsapp\_business\_messaging permission. HTTP 200 means the request was processed, not that every removal succeeded. Inspect any returned errors and group\_participants\_update webhooks for final per-participant outcomes; this action does not wait for webhooks.
>
> #### Input Parameters
>
> **group\_id** `string` *required*
>
> Group ID from group creation webhooks or the active groups listing.
>
> **participants** `array` *required*
>
> One to eight phone numbers or WhatsApp user IDs to remove, each supplied as a user object.
>
> **messaging\_product** `string`
>
> Messaging product; must be whatsapp.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Request preverified number code
>
> **Slug:** `WHATSAPP_REQUEST_PREVERIFIED_NUMBER_CODE`
>
> Request a verification code for a business-owned pre-verified phone number. Delivers a code using IVR, SMS, or VOICE during pre-verified number onboarding. Use the pre-verified phone number node ID, not an ordinary phone number ID. Submit the received code separately with WHATSAPP\_VERIFY\_PREVERIFIED\_NUMBER\_CODE. This action requests delivery; it does not complete verification.
>
> #### Input Parameters
>
> **language** `string` *required*
>
> Verification message locale, such as en\_US or en-US; extended locale codes are also supported. Unsupported languages fall back to en\_US.
>
> **user\_agent** `string`
>
> Optional User-Agent header identifying the client software.
>
> **code\_method** `string ("IVR" | "SMS" | "VOICE")` *required*
>
> Delivery method for the verification code: IVR, SMS, or VOICE.
>
> **pre\_verified\_phone\_number\_id** `string` *required*
>
> Pre-verified phone number node ID provided during pre-verification; find it in WhatsApp Business Account settings. This is not an ordinary WhatsApp Business phone number ID or a telephone number.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Request solution deactivation
>
> **Slug:** `WHATSAPP_REQUEST_SOLUTION_DEACTIVATION`
>
> Ask the partner to deactivate an owned WhatsApp Multi-Partner Solution. The operation reference allows ACTIVE or INITIATED solutions; the guide describes owner-created ACTIVE solutions. Meta validates eligibility. Processing is asynchronous: the solution enters PENDING\_DEACTIVATION and the partner is notified. It can still onboard clients until the partner accepts. Rejection leaves it ACTIVE; acceptance sets DEACTIVATED and stops client onboarding. Deactivated solutions cannot be edited. This submits the request only and does not accept the request or confirm final deactivation.
>
> #### Input Parameters
>
> **reason** `string`
>
> Optional reason for requesting deactivation (at most 500 characters).
>
> **solution\_id** `string` *required*
>
> Multi-Partner Solution ID from creation, the partner\_solutions webhook, or App Dashboard > WhatsApp > Partner solutions. You must be the solution owner.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Request verification code
>
> **Slug:** `WHATSAPP_REQUEST_VERIFICATION_CODE`
>
> Request an SMS or voice verification code for a WhatsApp Business phone number. Sends a code to the phone number as the first step of phone number verification. Submit the received code separately with WHATSAPP\_VERIFY\_CODE. This action does not verify the code or register the phone number for Cloud API messaging.
>
> #### Input Parameters
>
> **language** `string` *required*
>
> Language locale for the verification message, for example 'en\_US'.
>
> **user\_agent** `string`
>
> Optional User-Agent header identifying the client software.
>
> **code\_method** `string ("SMS" | "VOICE")` *required*
>
> Method for delivering the verification code: SMS or VOICE.
>
> **phone\_number\_id** `string` *required*
>
> WhatsApp Business phone number ID. Discover it with WHATSAPP\_GET\_PHONE\_NUMBERS; this is not the phone number itself.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send contacts
>
> **Slug:** `WHATSAPP_SEND_CONTACTS`
>
> Send contacts WhatsApp number. Note: The message will be delivered to the recipient only if they have initiated a conversation first.
>
> #### Input Parameters
>
> **contacts** `array` *required*
>
> List of contacts to send. Each contact requires a name object with formatted\_name, first\_name, and last\_name. Optional fields: addresses, birthday (YYYY-MM-DD), emails, org (company/department/title), and phones.
>
> **to\_number** `string` *required*
>
> The phone number to send the contacts to, including the country code without the + sign.
>
> **recipient\_type** `string ("individual" | "group")`
>
> The type of recipient. 'individual' (default) targets a phone number; 'group' targets a WhatsApp group id supplied in `to_number`.
>
> **phone\_number\_id** `string` *required*
>
> The phone number ID from which to send the contacts.
>
> **reply\_to\_message\_id** `string`
>
> Optional WhatsApp message ID (wamid...) of the message to reply to. When provided, this contact card is sent as a quoted reply (context.message\_id) in the conversation thread.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send encrypted message
>
> **Slug:** `WHATSAPP_SEND_ENCRYPTED_MESSAGE`
>
> Send a caller-encrypted WhatsApp message and return the encrypted response. Requires a registered business phone number with payload encryption enabled via POST /\<Phone-Number-ID>/settings, and caller-side encryption/decryption with externally managed keys. Supply a pre-encrypted JWE containing the original /messages payload. Sending is irreversible. This action neither performs local cryptography nor decrypts the response or confirms delivery. Successful responses are encrypted; provider errors can be unencrypted.
>
> #### Input Parameters
>
> **phone\_number\_id** `string` *required*
>
> Registered sender WhatsApp Business phone number ID, discovered with WHATSAPP\_GET\_PHONE\_NUMBERS. Payload encryption must already be enabled through POST /\<Phone-Number-ID>/settings.
>
> **messaging\_product** `string`
>
> Messaging product; always whatsapp.
>
> **encrypted\_contents** `string` *required*
>
> Pre-encrypted JWE string containing a payload with the original /messages structure. The caller must encrypt using provider-supported algorithms and manage keys externally. Forwarded exactly as supplied; no local encryption or JWE validation is performed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send interactive buttons
>
> **Slug:** `WHATSAPP_SEND_INTERACTIVE_BUTTONS`
>
> Send an interactive button message with up to 3 reply buttons to a WhatsApp user. Interactive button messages allow recipients to quickly respond by tapping predefined buttons. Perfect for yes/no questions, multiple choice selections, quick actions, or call-to-action scenarios. IMPORTANT REQUIREMENTS: - The recipient must be a registered WhatsApp user - The recipient must have messaged your business first within the last 24 hours (WhatsApp's customer service window) - You can include 1-3 buttons per message - Each button can have a title (max 20 chars) and unique ID (max 256 chars) Use cases: Customer service menus, appointment confirmations, feedback collection, product selections.
>
> #### Input Parameters
>
> **buttons** `array` *required*
>
> List of 1-3 interactive buttons. Each button must have a unique ID and title.
>
> **body\_text** `string` *required*
>
> Main message text explaining the purpose or question for the buttons (maximum 1024 characters).
>
> **to\_number** `string` *required*
>
> Recipient's phone number in international format without the + sign (e.g., '14155552345' for a US number). The recipient must be a registered WhatsApp user and must have messaged your business within the last 24 hours.
>
> **footer\_text** `string`
>
> Optional footer text displayed at the bottom of the message, below the buttons (maximum 60 characters).
>
> **header\_text** `string`
>
> Optional header text displayed at the top of the message (maximum 60 characters).
>
> **phone\_number\_id** `string` *required*
>
> The WhatsApp Business phone number ID from which to send the message. Get this from the WHATSAPP\_GET\_PHONE\_NUMBERS action.
>
> **reply\_to\_message\_id** `string`
>
> Optional message ID to reply to. Use this to create a threaded conversation by replying to a specific previous message.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send interactive list
>
> **Slug:** `WHATSAPP_SEND_INTERACTIVE_LIST`
>
> Send an interactive list message to a WhatsApp number. List messages display a menu of options organized into sections. Users tap a button to view the list and select one option. Perfect for product catalogs, service menus, or guided workflows. Supports up to 10 sections with up to 10 items per section (100 total options). Note: Recipients must have messaged you first within the last 24 hours to receive this message.
>
> #### Input Parameters
>
> **sections** `array` *required*
>
> Sections containing list items (maximum 10 sections, minimum 1 section).
>
> **body\_text** `string` *required*
>
> Body text for the list message (up to 1024 characters).
>
> **to\_number** `string` *required*
>
> The recipient's phone number in international format without the + sign (e.g., '15551234567' for a US number). Note: The recipient must have initiated a conversation with your WhatsApp Business account within the last 24 hours to receive this message.
>
> **button\_text** `string` *required*
>
> Text for the list button (up to 20 characters).
>
> **footer\_text** `string`
>
> Footer text for the list message (up to 60 characters).
>
> **header\_text** `string`
>
> Header text for the list message (up to 60 characters).
>
> **phone\_number\_id** `string` *required*
>
> The Meta-assigned numeric ID for the WhatsApp Business phone number to send from. This is NOT the actual phone number itself - it is a numeric ID (e.g., '901139066420489') assigned by Meta. Obtain it using WHATSAPP\_GET\_PHONE\_NUMBERS action which returns the 'id' field for each phone number.
>
> **reply\_to\_message\_id** `string`
>
> The ID of the message to reply to (optional).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send location
>
> **Slug:** `WHATSAPP_SEND_LOCATION`
>
> Send a location message with coordinates, name, and address to a WhatsApp user. This action allows you to share location information through WhatsApp Business API. The location message includes latitude/longitude coordinates, a location name, and address. Important: The recipient must have an active WhatsApp account. Additionally, you can only send free-form messages (like location messages) within the 24-hour customer service window after the recipient has initiated contact with your business. Outside this window, you must use approved message templates. Common error codes: - 133010: Recipient's phone number doesn't have a WhatsApp account - 131026: Message undeliverable (recipient may have blocked your business number) - 131047: Re-engagement message (outside 24-hour window, need to use template)
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name or title of the location (e.g., 'San Francisco City Hall', 'Golden Gate Bridge'). This will be displayed to the recipient.
>
> **address** `string` *required*
>
> The full address of the location (e.g., '1 Dr Carlton B Goodlett Pl, San Francisco, CA 94102'). This provides context to the recipient about the location.
>
> **latitude** `string` *required*
>
> The latitude coordinate of the location in decimal degrees format (e.g., '37.7749' for San Francisco). Range: -90 to 90.
>
> **longitude** `string` *required*
>
> The longitude coordinate of the location in decimal degrees format (e.g., '-122.4194' for San Francisco). Range: -180 to 180.
>
> **to\_number** `string` *required*
>
> The recipient's WhatsApp phone number in international format without the + sign or spaces (e.g., '14155238886' for US number). The recipient must have a WhatsApp account registered with this number.
>
> **phone\_number\_id** `string` *required*
>
> The WhatsApp Business phone number ID from which to send the location message. This is the ID of your WhatsApp Business phone number, not the phone number itself.
>
> **reply\_to\_message\_id** `string`
>
> Optional WhatsApp message ID (wamid...) of the message to reply to. When provided, this location is sent as a quoted reply (context.message\_id) in the conversation thread.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send marketing message
>
> **Slug:** `WHATSAPP_SEND_MARKETING_MESSAGE`
>
> Send an approved marketing template through the Marketing Messages API. Requires MM onboarding, a registered business phone number and an approved marketing template. Cloud API fallback depends on product\_policy and account settings. Accepts phone numbers or BSUIDs; acceptance does not imply delivery.
>
> #### Input Parameters
>
> **to** `string`
>
> Recipient WhatsApp phone number. Supply to or recipient; when both are supplied, to takes precedence.
>
> **type** `string` *required*
>
> Only template messages are supported by this endpoint.
>
> **bid\_spec** `object`
>
> Optional beta send-time max-price adjustment.
>
> **template** `object` *required*
>
> Approved marketing template and its variable parameters.
>
> **recipient** `string`
>
> Recipient BSUID or parent BSUID obtained from WhatsApp webhooks. Used only when to is omitted. BSUID sends disable delivery optimization and cannot use dynamic-pricing templates.
>
> **product\_policy** `string ("CLOUD_API_FALLBACK" | "STRICT")`
>
> CLOUD\_API\_FALLBACK allows Cloud API routing if MM onboarding is incomplete (provider default). STRICT disables fallback.
>
> **recipient\_type** `string` *required*
>
> Marketing message recipient type; must be individual.
>
> **phone\_number\_id** `string` *required*
>
> Registered sender business phone number ID, discovered with WHATSAPP\_GET\_PHONE\_NUMBERS.
>
> **messaging\_product** `string` *required*
>
> Messaging product; must be whatsapp.
>
> **message\_activity\_sharing** `boolean`
>
> Enable or disable sharing this message's activity with Meta. Omit to use the account setting.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send media
>
> **Slug:** `WHATSAPP_SEND_MEDIA`
>
> Send a media message to a WhatsApp number using a media URL. The recipient must have texted first to receive the media.
>
> #### Input Parameters
>
> **link** `string` *required*
>
> The publicly accessible HTTPS URL of the media file to send. The URL must be accessible by WhatsApp servers and serve the appropriate content-type header. For media uploads, use WHATSAPP\_UPLOAD\_MEDIA action to get a media ID and use WHATSAPP\_SEND\_MEDIA\_BY\_ID instead.
>
> **caption** `string`
>
> Optional caption text to accompany the media (max 1024 characters). Only supported for 'image', 'video', and 'document' media types. Captions are NOT supported for 'audio' and 'sticker' types.
>
> **to\_number** `string` *required*
>
> The phone number to send the media to, including the country code without the + sign.
>
> **media\_type** `string ("audio" | "document" | "image" | "sticker" | "video")` *required*
>
> The type of media to send. Options: 'audio' (voice messages), 'document' (PDFs, docs), 'image' (PNG, JPG), 'sticker' (WebP animated stickers), 'video' (MP4 videos). Note: Only 'image', 'video', and 'document' types support captions.
>
> **phone\_number\_id** `string` *required*
>
> The Meta-assigned numeric ID for the WhatsApp Business phone number to send from. This is NOT the actual phone number itself - it is a numeric ID (e.g., '901139066420489') assigned by Meta. Obtain it using WHATSAPP\_GET\_PHONE\_NUMBERS action which returns the 'id' field for each phone number.
>
> **reply\_to\_message\_id** `string`
>
> Optional WhatsApp message ID (wamid...) of the message to reply to. When provided, this media message is sent as a quoted reply (context.message\_id) in the conversation thread.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send media by
>
> **Slug:** `WHATSAPP_SEND_MEDIA_BY_ID`
>
> Send media using a media ID from previously uploaded media. This is more efficient than sending media by URL as the media is already on WhatsApp servers. Use upload\_media action first to get the media ID. Note: The media will be delivered to the recipient only if they have texted first.
>
> #### Input Parameters
>
> **caption** `string`
>
> Caption for the media (not supported for audio and sticker).
>
> **filename** `string`
>
> Filename for document media.
>
> **media\_id** `string` *required*
>
> The media ID from uploaded media (use upload\_media action to get this ID).
>
> **to\_number** `string` *required*
>
> The phone number to send the media to, including the country code without the + sign.
>
> **media\_type** `string ("audio" | "document" | "image" | "sticker" | "video")` *required*
>
> The type of media to send: audio, document, image, sticker, or video.
>
> **phone\_number\_id** `string` *required*
>
> The phone number ID from which to send the media.
>
> **reply\_to\_message\_id** `string`
>
> The ID of the message to reply to (optional).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send message
>
> **Slug:** `WHATSAPP_SEND_MESSAGE`
>
> Send a text message to a WhatsApp user. Important: The recipient phone number must be registered on WhatsApp and must have initiated a conversation with your business within the last 24 hours, OR you must use a template message (see WHATSAPP\_SEND\_TEMPLATE\_MESSAGE) for the first message outside the 24-hour window. For test accounts, recipient numbers must be added to the test recipient list in Meta Business Suite before sending messages.
>
> #### Input Parameters
>
> **text** `string` *required*
>
> The text content of the message to send. Supports Unicode characters including emojis. Maximum length: 4096 characters.
>
> **to\_number** `string` *required*
>
> The recipient's WhatsApp phone number in international format without the + sign (e.g., '14155551234' for a US number). The number must be registered on WhatsApp.
>
> **message\_id** `string`
>
> Optional: The WhatsApp message ID (wamid) to reply to. When provided, this message will be sent as a reply to the specified message, creating a quoted reply thread. Leave empty to send a regular message.
>
> **preview\_url** `boolean`
>
> Set to True to show a preview card for URLs in the message. When enabled, WhatsApp will fetch and display URL metadata (title, description, image) for the first URL in the message. Default: False.
>
> **phone\_number\_id** `string` *required*
>
> The Meta-assigned numeric ID for the WhatsApp Business phone number to send from. This is NOT the actual phone number itself - it is a numeric ID (e.g., '712594308615206') assigned by Meta. Obtain it using WHATSAPP\_GET\_PHONE\_NUMBERS action which returns the 'id' field for each phone number.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send template message
>
> **Slug:** `WHATSAPP_SEND_TEMPLATE_MESSAGE`
>
> Send a template message to a WhatsApp number.
>
> #### Input Parameters
>
> **to\_number** `string` *required*
>
> The phone number to send the template message to, including the country code without the + sign.
>
> **components** `array`
>
> Template components with parameters to fill template variables. Use 'body' type with text parameters for simple variable substitution.
>
> **language\_code** `string ("af" | "sq" | "ar" | "ar_EG" | "ar_AE" | "ar_LB" | "ar_MA" | "ar_QA" | "az" | "be_BY" | "bn" | "bn_IN" | "bg" | "ca" | "zh_CN" | "zh_HK" | "zh_TW" | "hr" | "cs" | "da" | "prs_AF" | "nl" | "nl_BE" | "en" | "en_GB" | "en_US" | "en_AE" | "en_AU" | "en_CA" | "en_GH" | "en_IE" | "en_IN" | "en_JM" | "en_MY" | "en_NZ" | "en_QA" | "en_SG" | "en_UG" | "en_ZA" | "et" | "fil" | "fi" | "fr" | "fr_BE" | "fr_CA" | "fr_CH" | "fr_CI" | "fr_MA" | "ka" | "de" | "de_AT" | "de_CH" | "el" | "gu" | "ha" | "he" | "hi" | "hu" | "id" | "ga" | "it" | "ja" | "kn" | "kk" | "rw_RW" | "ko" | "ky_KG" | "lo" | "lv" | "lt" | "mk" | "ms" | "ml" | "mr" | "nb" | "ps_AF" | "fa" | "pl" | "pt_BR" | "pt_PT" | "pa" | "ro" | "ru" | "sr" | "si_LK" | "sk" | "sl" | "es" | "es_AR" | "es_CL" | "es_CO" | "es_CR" | "es_DO" | "es_EC" | "es_HN" | "es_MX" | "es_PA" | "es_PE" | "es_ES" | "es_UY" | "sw" | "sv" | "ta" | "te" | "th" | "tr" | "uk" | "ur" | "uz" | "vi" | "zu")`
>
> The language code for the template.
>
> **template\_name** `string` *required*
>
> The name of the template to be sent.
>
> **phone\_number\_id** `string` *required*
>
> The phone number ID from which to send the template message.
>
> **reply\_to\_message\_id** `string`
>
> Optional WhatsApp message ID (wamid...) of the message to reply to. When provided, this template message is sent as a quoted reply (context.message\_id) in the conversation thread.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set business encryption
>
> **Slug:** `WHATSAPP_SET_BUSINESS_ENCRYPTION`
>
> Set the RSA public key used to encrypt WhatsApp message payloads and data channel requests. Upload a PEM public key for a WhatsApp Business phone number. Only one public key is active per phone number; uploading a new key replaces the previous key. Keep the corresponding private key outside this action.
>
> #### Input Parameters
>
> **phone\_number\_id** `string` *required*
>
> WhatsApp Business phone number ID. Discover it with WHATSAPP\_GET\_PHONE\_NUMBERS.
>
> **business\_public\_key** `string` *required*
>
> RSA public key in PEM format to upload and sign for payload encryption. Supply only the public key, never a private key. Replaces the phone number's previous public key.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set obo mobility intent
>
> **Slug:** `WHATSAPP_SET_OBO_MOBILITY_INTENT`
>
> Set OBO mobility intent for a Multi-Partner Solution associated with a client WABA. For authorized solution providers/partners managing client accounts. Establishes On-Behalf-Of relationships and configures provider access and messaging mobility; settings may take a few minutes to propagate. The legacy OBO account ownership model is retired and replaced by partner-initiated account creation, but this operation remains in the official v23 spec. Confirm account eligibility with Meta; its presence in the spec does not guarantee availability for new OBO onboarding. Returns the provider's success flag, intent ID and any failure explanation.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> OBO mobility intent configuration, including the required body waba\_id.
>
> **waba\_id** `string` *required*
>
> Path WhatsApp Business Account ID; find in Business Manager or owned/shared WABA listings. Requires solution-provider access to the client WABA.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set solution migration intent
>
> **Slug:** `WHATSAPP_SET_SOLUTION_MIGRATION_INTENT`
>
> Set migration intent for a Multi-Partner Solution associated with a WABA. Requires an authorized solution partner with access to the WABA and eligible source/target solutions. Initiate, schedule, confirm, or cancel migration; Meta validates eligibility and pending state. This can change partner arrangements, trigger partner notifications, and execute migration at the scheduled time or immediately upon confirmation. A successful response records the intent, not proof that migration completed.
>
> #### Input Parameters
>
> **body** `object` *required*
>
> Migration intent JSON body for the solution associated with this WABA.
>
> **waba\_id** `string` *required*
>
> WhatsApp Business Account ID from owned/shared WABA listings or WhatsApp Business Manager. Requires authorized solution-partner access.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set WhatsApp Two-Step Verification PIN
>
> **Slug:** `WHATSAPP_SET_TWO_STEP_VERIFICATION`
>
> Set or reset the two-step verification PIN for a WhatsApp Business phone number. Use when you need to change the 6-digit PIN that protects a registered phone number — for example after onboarding a new number, rotating credentials, or before re-registering. The initial PIN is set via register\_phone; this action updates the PIN on an already-registered phone number. Endpoint: `POST /{phone-number-id}` with body `{"pin": "XXXXXX"}`. Meta's two-step-verification reference page is SPA-rendered, so the operation is documented as a property update on the phone-number node itself rather than a dedicated sub-path.
>
> #### Input Parameters
>
> **pin** `string` *required*
>
> New 6-digit two-step verification PIN. Must be exactly 6 digits.
>
> **phone\_number\_id** `string` *required*
>
> The ID of the phone number whose two-step verification PIN should be set or reset.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Share preverified numbers
>
> **Slug:** `WHATSAPP_SHARE_PREVERIFIED_NUMBERS`
>
> Share a number from a business's pre-verified phone number pool with a partner. Requires ownership or sharing rights to the pre-verified number and a valid partner business accessible to the requesting app. The number retains its original ownership. Business relationship and access-control policies must allow the share; this action does not assign business roles or verify a number.
>
> #### Input Parameters
>
> **business\_id** `string` *required*
>
> Business portfolio ID that owns or has sharing rights to the pre-verified number. Find it in Meta Business Manager or business management APIs.
>
> **preverified\_id** `string` *required*
>
> Pre-verified phone number ID to share from the business's pool. Discover it with WHATSAPP\_LIST\_PREVERIFIED\_NUMBERS; the requesting business must own it or have sharing rights.
>
> **partner\_business\_id** `string` *required*
>
> Partner business portfolio ID receiving access. Obtain it from the partner's Meta Business Manager; it must identify a valid business accessible to the requesting app.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Subscribe to WABA Webhooks
>
> **Slug:** `WHATSAPP_SUBSCRIBE_APP`
>
> Subscribe your application to webhook notifications for the WhatsApp Business Account configured on the connection, using the configured app webhook settings.
>
> #### Input Parameters
>
> **waba\_id** `string`
>
> WhatsApp Business Account ID to subscribe to. If not provided, uses the WABA ID from auth headers.
>
> **verify\_token** `string`
>
> Verification token for webhook security. This token will be used to verify webhook callbacks.
>
> **override\_callback\_uri** `string`
>
> Custom webhook callback URL to override app default. Must be a valid HTTPS URL.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Unblock WhatsApp Users
>
> **Slug:** `WHATSAPP_UNBLOCK_USERS`
>
> Unblock WhatsApp users so they can contact the business phone number again. Sends a DELETE with a JSON body. Inspect removed\_users, failed\_users and error: a successful HTTP response can contain partial or complete per-user failures.
>
> #### Input Parameters
>
> **block\_users** `array`
>
> Users to unblock, at most 1,000 per request. The DELETE reference marks this body field optional; supply users to perform an unblock.
>
> **phone\_number\_id** `string` *required*
>
> Meta-assigned business phone number ID, not its display phone number. Discover with WHATSAPP\_GET\_PHONE\_NUMBERS.
>
> **messaging\_product** `string`
>
> Messaging product; use 'whatsapp'. Optional in the endpoint reference.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Unsubscribe from WABA Webhooks
>
> **Slug:** `WHATSAPP_UNSUBSCRIBE_APP`
>
> Unsubscribe your application from webhook events for the connection-bound WhatsApp Business Account, for example when cleaning up an integration. If an account ID is supplied, it must match the connection. A success result does not always confirm that the subscription was removed.
>
> #### Input Parameters
>
> **waba\_id** `string`
>
> WhatsApp Business Account ID to unsubscribe from. If not provided, uses the WABA ID from auth headers.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update WhatsApp Flow Metadata
>
> **Slug:** `WHATSAPP_UPDATE_BUSINESS_ACCOUNT`
>
> Update metadata for a WhatsApp Flow including its name, categories, and endpoint URI. Use when you need to modify the configuration or settings of an existing WhatsApp Flow.
>
> #### Input Parameters
>
> **name** `string`
>
> The new name for the Flow.
>
> **flow\_id** `string` *required*
>
> The unique identifier of the Flow to update. Get this from the WHATSAPP\_LIST\_FLOWS action which returns the 'id' field for each flow.
>
> **categories** `array`
>
> List of categories to assign to the Flow (e.g., \['OTHER', 'SIGN\_UP']).
>
> **endpoint\_uri** `string`
>
> The endpoint URI where the Flow will send data.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update business account settings
>
> **Slug:** `WHATSAPP_UPDATE_BUSINESS_ACCOUNT_SETTINGS`
>
> Update a WhatsApp Business Account's name or timezone identifier. Supply the WABA ID from WhatsApp Manager or the business management APIs. Omitted settings are left unchanged. This operation updates account settings, not WhatsApp Flow metadata.
>
> #### Input Parameters
>
> **name** `string`
>
> Updated name for the WhatsApp Business Account.
>
> **waba\_id** `string` *required*
>
> WhatsApp Business Account ID. Find it in WhatsApp Manager or through the business management APIs; this is not a Flow ID or phone number ID.
>
> **timezone\_id** `string`
>
> Updated timezone identifier for the WhatsApp Business Account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update business compliance info
>
> **Slug:** `WHATSAPP_UPDATE_BUSINESS_COMPLIANCE_INFO`
>
> Create or update regulatory compliance information for a WhatsApp Business phone number. Supply legal entity details and grievance officer and customer care contacts. Discover the phone number ID with WHATSAPP\_GET\_PHONE\_NUMBERS.
>
> #### Input Parameters
>
> **entity\_name** `string` *required*
>
> Legal business entity name (2–128 characters).
>
> **entity\_type** `string ("LIMITED_LIABILITY_PARTNERSHIP" | "SOLE_PROPRIETORSHIP" | "PARTNERSHIP" | "PUBLIC_COMPANY" | "PRIVATE_COMPANY" | "OTHER")` *required*
>
> Legal business entity type.
>
> **is\_registered** `boolean`
>
> Whether officially registered; allowed only for OTHER or PARTNERSHIP.
>
> **phone\_number\_id** `string` *required*
>
> WhatsApp Business phone number ID, not the phone number itself. Discover with WHATSAPP\_GET\_PHONE\_NUMBERS or Business Manager.
>
> **messaging\_product** `string` *required*
>
> Messaging product identifier; must be whatsapp.
>
> **entity\_type\_custom** `string`
>
> Custom entity type; required for OTHER and forbidden for other entity types.
>
> **customer\_care\_details** `object` *required*
>
> Customer care contact details; email is required.
>
> **grievance\_officer\_details** `object` *required*
>
> Grievance officer contact details; name and email are required.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update WhatsApp Business Profile
>
> **Slug:** `WHATSAPP_UPDATE_BUSINESS_PROFILE`
>
> Update WhatsApp Business Profile information including business details, contact information, and profile settings. Use when you need to modify the business profile settings such as the about text, business category, address, description, email, and website URLs associated with a WhatsApp Business phone number. Note: Only fields that are provided will be updated. To clear an optional field, pass an empty string for text fields or an empty array for websites.
>
> #### Input Parameters
>
> **about** `string`
>
> The text to display in the business profile's About section. Maximum 139 characters.
>
> **email** `string`
>
> The contact email address of the business. Maximum 128 characters.
>
> **address** `string`
>
> The address of the business. Maximum 256 characters.
>
> **vertical** `string ("OTHER" | "AUTO" | "BEAUTY" | "APPAREL" | "EDU" | "ENTERTAIN" | "EVENT_PLAN" | "FINANCE" | "GROCERY" | "GOVT" | "HOTEL" | "HEALTH" | "NONPROFIT" | "PROF_SERVICES" | "RETAIL" | "TRAVEL" | "RESTAURANT" | "ALCOHOL" | "ONLINE_GAMBLING" | "PHYSICAL_GAMBLING" | "OTC_DRUGS")`
>
> The industry/vertical type of the WhatsApp Business account.
>
> **websites** `array`
>
> List of URLs associated with the business. Maximum 2 URLs allowed.
>
> **description** `string`
>
> Description of the business. Maximum 256 characters.
>
> **phone\_number\_id** `string` *required*
>
> The Meta-assigned numeric ID for the WhatsApp Business phone number. This is NOT the actual phone number - it is a numeric ID (e.g., '712594308615206') assigned by Meta. Obtain it using WHATSAPP\_GET\_PHONE\_NUMBERS action which returns the 'id' field for each phone number.
>
> **messaging\_product** `string`
>
> The messaging service used for the request. Must be set to 'whatsapp'.
>
> **profile\_picture\_handle** `string`
>
> The handle of the profile picture generated from the Resumable Upload API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update business profile node
>
> **Slug:** `WHATSAPP_UPDATE_BUSINESS_PROFILE_NODE`
>
> Update a WhatsApp Business Profile directly by its profile node ID. Sends POST /\{profile-id} with business details, contact information, industry vertical, websites, or a previously uploaded profile picture handle. Distinct from WHATSAPP\_UPDATE\_BUSINESS\_PROFILE, which updates the /\{phone-number-id}/whatsapp\_business\_profile edge. Returns the provider's optional profile ID and success flag without synthesizing success.
>
> #### Input Parameters
>
> **about** `string`
>
> Business profile about text.
>
> **email** `string`
>
> Business contact email address.
>
> **address** `string`
>
> Physical business address.
>
> **vertical** `string ("ALCOHOL" | "APPAREL" | "AUTO" | "BEAUTY" | "EDU" | "ENTERTAIN" | "EVENT_PLAN" | "FINANCE" | "GOVT" | "GROCERY" | "HEALTH" | "HOTEL" | "MATRIMONY_SERVICE" | "NONPROFIT" | "NOT_A_BIZ" | "ONLINE_GAMBLING" | "OTHER" | "OTC_DRUGS" | "PHYSICAL_GAMBLING" | "PROF_SERVICES" | "RESTAURANT" | "RETAIL" | "TRAVEL" | "UNDEFINED")`
>
> Business industry vertical classification.
>
> **websites** `array`
>
> Website URLs associated with the business.
>
> **description** `string`
>
> Business description text.
>
> **messaging\_product** `string` *required*
>
> Messaging service used for the request; must be whatsapp.
>
> **profile\_picture\_handle** `string`
>
> Profile picture handle obtained through the Resumable Upload API.
>
> **whatsapp\_business\_profile\_id** `string` *required*
>
> WhatsApp Business Profile node ID, found in WhatsApp Business Manager or through business management APIs. Supply the profile ID, not a phone number ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update WhatsApp commerce settings
>
> **Slug:** `WHATSAPP_UPDATE_COMMERCE_SETTINGS`
>
> Set or update commerce settings for a WhatsApp Business phone number. Use this action to enable or disable shopping cart functionality and product catalog visibility for a specific WhatsApp Business phone number. The settings control whether customers can browse products and make purchases directly within WhatsApp. Note: At least one setting (is\_cart\_enabled or is\_catalog\_visible) should be provided in the request for meaningful updates.
>
> #### Input Parameters
>
> **is\_cart\_enabled** `boolean`
>
> Enable or disable the shopping cart feature. When enabled, customers can add items to a cart and checkout directly in WhatsApp.
>
> **phone\_number\_id** `string` *required*
>
> The Meta-assigned numeric ID for the WhatsApp Business phone number (e.g., '712594308615206'). This is NOT the actual phone number - it is a numeric ID assigned by Meta. Obtain it using WHATSAPP\_GET\_PHONE\_NUMBERS action which returns the 'id' field for each phone number.
>
> **is\_catalog\_visible** `boolean`
>
> Make the product catalog visible to customers. When enabled, customers can browse your products directly in WhatsApp.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Flow JSON
>
> **Slug:** `WHATSAPP_UPDATE_FLOW_JSON`
>
> Update the Flow JSON configuration for an existing WhatsApp Flow by uploading a file or inline JSON. The response may include validation errors; JSON error responses can also be returned without raising an HTTP error.
>
> #### Input Parameters
>
> **flow\_id** `string` *required*
>
> The unique identifier of the flow. This is the ID assigned by Meta when the flow is created.
>
> **asset\_type** `string`
>
> The asset type being uploaded. Must be 'FLOW\_JSON' for Flow JSON updates.
>
> **rawContent** `string`
>
> Inline JSON content to upload as a string. Provide either file\_to\_upload or raw\_content.
>
> **file\_to\_upload** `object`
>
> The flow\.json file to upload. The file name should be 'flow\.json'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update group
>
> **Slug:** `WHATSAPP_UPDATE_GROUP`
>
> Update an existing WhatsApp group's subject, description, or photo. Requires an eligible Official Business Account using Cloud API. Omitted settings are not sent. Supplying file uploads the photo using multipart form data; otherwise settings are sent as JSON. HTTP acceptance does not establish that every setting changed: inspect group\_settings\_update webhooks for success, partial failure, or total failure.
>
> #### Input Parameters
>
> **file** `object`
>
> Group profile picture to upload as multipart file data. Must be JPEG, maximum 5 MB, square, and at least 192 by 192 pixels. Omit to send a JSON-only settings update.
>
> **subject** `string`
>
> New group subject, 1–128 characters. Omit to leave unchanged.
>
> **group\_id** `string` *required*
>
> WhatsApp group ID. Obtain it from WHATSAPP\_LIST\_GROUPS or the group creation lifecycle webhook.
>
> **description** `string`
>
> New group description, at most 2048 characters. Omit to leave unchanged.
>
> **messaging\_product** `string`
>
> Messaging product; must be whatsapp.
>
> **profile\_picture\_file** `string`
>
> Provider-documented profile\_picture\_file path, forwarded unchanged as text. For an actual binary photo upload, use file instead; no path is inferred from the uploaded file.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update official business account status
>
> **Slug:** `WHATSAPP_UPDATE_OFFICIAL_BUSINESS_ACCOUNT_STATUS`
>
> Submit OBA application information or update application data for a phone number. Sends business website, country, and optional notability information to the Official Business Account application/update endpoint. This does not directly set approval status. Although the reference mentions withdrawal and resubmission, it documents no intent selector; this action exposes only the documented payload. Meta enforces eligibility and application-state transitions.
>
> #### Input Parameters
>
> **phone\_number\_id** `string` *required*
>
> WhatsApp Business phone number ID, not the telephone number. Obtain the id from WHATSAPP\_GET\_PHONE\_NUMBERS.
>
> **primary\_language** `string`
>
> Primary language used by the business.
>
> **supporting\_links** `array`
>
> Supporting URLs demonstrating business notability; provide 5 to 10 links when supplied.
>
> **business\_website\_url** `string` *required*
>
> Official business website URL.
>
> **parent\_business\_or\_brand** `string`
>
> Parent business or brand name.
>
> **primary\_country\_of\_operation** `string` *required*
>
> Primary country where the business operates.
>
> **additional\_supporting\_information** `string`
>
> Additional information supporting the OBA application.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update WhatsApp Cloud API Settings
>
> **Slug:** `WHATSAPP_UPDATE_SETTINGS`
>
> Update Cloud API settings for a WhatsApp Business phone number. Use this action to modify calling features, user identity verification settings, payload encryption configuration, and data storage preferences for a specific WhatsApp Business phone number. Note: Only one setting type can be updated per request (calling, user\_identity\_change, payload\_encryption, or storage\_configuration). The API uses a oneOf schema, so including multiple setting types will result in an error.
>
> #### Input Parameters
>
> **calling** `object`
>
> Calling feature settings.
>
> **phone\_number\_id** `string` *required*
>
> The WhatsApp Business phone number ID (e.g., '712594308615206'). Get this from the WHATSAPP\_GET\_PHONE\_NUMBERS action.
>
> **payload\_encryption** `object`
>
> Payload encryption settings.
>
> **user\_identity\_change** `object`
>
> User identity change settings.
>
> **storage\_configuration** `object`
>
> Storage configuration settings.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload file chunk
>
> **Slug:** `WHATSAPP_UPLOAD_FILE_CHUNK`
>
> Upload raw file bytes to a resumable upload session and return its file handle. Create the session first with WHATSAPP\_CREATE\_UPLOAD\_SESSION. To resume, retrieve WHATSAPP\_GET\_UPLOAD\_OFFSET and supply the remaining bytes with that offset. The connected account must provide the user access token required by the Resumable Upload API.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> File containing the bytes to upload. For a resumed upload, supply only the remaining bytes starting at file\_offset; this action does not slice the file.
>
> **file\_offset** `integer`
>
> Byte offset in the upload session: 0 for a new upload, or the file\_offset returned by WHATSAPP\_GET\_UPLOAD\_OFFSET when resuming.
>
> **upload\_session\_id** `string` *required*
>
> Session ID returned by WHATSAPP\_CREATE\_UPLOAD\_SESSION. Pass the returned id, including upload: and any ?sig= signature, unchanged; a bare session ID is also accepted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload media
>
> **Slug:** `WHATSAPP_UPLOAD_MEDIA`
>
> Upload media files (images, videos, audio, documents, stickers) to WhatsApp servers. The uploaded media gets a media ID that can be used in send\_media or other messaging actions. Supported formats: - Images: JPEG, PNG (max 5MB) - Videos: MP4, 3GPP (max 16MB) - Audio: AAC, M4A, AMR, MP3, OGG (max 16MB) - Documents: PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX (max 100MB) - Stickers: WebP (max 500KB, 512x512 pixels)
>
> #### Input Parameters
>
> **media\_type** `string ("image" | "video" | "audio" | "document" | "sticker")` *required*
>
> Type of media being uploaded: image, video, audio, document, or sticker.
>
> **file\_to\_upload** `object` *required*
>
> Media file to upload to WhatsApp (max 16MB for most types, 100MB for videos).
>
> **phone\_number\_id** `string` *required*
>
> The phone number ID to upload media for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upsert message template
>
> **Slug:** `WHATSAPP_UPSERT_MESSAGE_TEMPLATE`
>
> Create or update a message template for the WhatsApp Business Account. Use this action when you need to create a new message template or update an existing one with the same name. If a template with the same name and language exists, it will be updated. Otherwise, a new template will be created. Templates must be approved by WhatsApp before they can be used. Templates are required for marketing messages and messages sent outside the 24-hour window.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Unique template name. Must be lowercase, alphanumeric with underscores only. Maximum 512 characters. Example: 'order\_confirmation\_v1'.
>
> **waba\_id** `string`
>
> WhatsApp Business Account ID. If not provided, uses the waba\_id from your connection configuration.
>
> **category** `string ("AUTHENTICATION" | "MARKETING" | "UTILITY")` *required*
>
> Template category. AUTHENTICATION: for OTP/verification codes. MARKETING: for promotional content (requires opt-in). UTILITY: for transactional updates like order status, appointments.
>
> **language** `string` *required*
>
> Template language code in ISO 639-1 format with country code. Examples: 'en\_US' (US English), 'es\_ES' (Spanish), 'pt\_BR' (Brazilian Portuguese).
>
> **components** `array` *required*
>
> List of template components. Must include at least one BODY component. Can optionally include one HEADER, one FOOTER, and one BUTTONS component.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Verify Phone Number OTP Code
>
> **Slug:** `WHATSAPP_VERIFY_CODE`
>
> Verify the OTP code for a pre-verified phone number. Use when you need to complete phone number verification by submitting the received OTP code. The phone number must first be added to your WhatsApp Business Account and a verification code must have been requested through the setup process. This action completes the verification by submitting the 6-digit code received via SMS or voice call. Note: This action verifies a phone number that has been pre-verified and is awaiting OTP confirmation.
>
> #### Input Parameters
>
> **code** `string` *required*
>
> 6-digit verification code received via SMS or voice call. The code must be exactly 6 digits.
>
> **phone\_number\_id** `string` *required*
>
> The ID of the phone number to verify. This ID is provided when the phone number is added to your WhatsApp Business Account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Verify preverified number code
>
> **Slug:** `WHATSAPP_VERIFY_PREVERIFIED_NUMBER_CODE`
>
> Verify an OTP for a pre-verified phone number to complete verification. First request a code with WHATSAPP\_REQUEST\_PREVERIFIED\_NUMBER\_CODE, then submit the received code with the same pre-verified phone number node ID. This updates the number's verification status. Expired, invalid, or reused codes fail.
>
> #### Input Parameters
>
> **code** `string` *required*
>
> Numeric verification code received via SMS or voice after requesting a code with WHATSAPP\_REQUEST\_PREVERIFIED\_NUMBER\_CODE. Codes expire and can only be used once.
>
> **user\_agent** `string`
>
> Optional User-Agent header identifying the client software.
>
> **pre\_verified\_phone\_number\_id** `string` *required*
>
> Pre-verified phone number node ID returned when creating the pre-verified number; find it in WhatsApp Business Manager or the pre-verified phone number listing. This is not a telephone number.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Who Am I
>
> **Slug:** `WHATSAPP_WHO_AM_I`
>
> Return the identity (name) of the connected WhatsApp (Meta) account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

## Triggers

> [accordion] Message Status Updated
>
> **Slug:** `WHATSAPP_MESSAGE_STATUS_UPDATED_TRIGGER`
>
> **Type:** poll
>
> Triggers when a WhatsApp message status changes.
>
> IMPORTANT LIMITATION: WhatsApp Cloud API does not provide a native polling endpoint for message status. Status updates are ONLY delivered via webhooks in real-time. This trigger cannot directly poll the WhatsApp API for status updates.
>
> This trigger will return empty results as WhatsApp does not support this operation. To track message status updates, you must:
>
> 1. Set up a webhook endpoint to receive status notifications from WhatsApp
> 2. Store the webhook data in your own database
> 3. Use a different mechanism to query your stored webhook data
>
> For more information, see:
>
> * [https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks](https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks)
>
> #### Configuration
>
> **interval** `number`
>
> Deprecated: use `polling_interval` on the trigger instance instead. Minutes between checks for new events.
>
> **max\_results** `integer`
>
> Maximum number of status updates to retrieve in each poll (1-100).
>
> **phone\_number\_id** `string` *required*
>
> The Meta-assigned numeric ID for the WhatsApp Business phone number to monitor. This is NOT the actual phone number itself - it is a numeric ID (e.g., '712594308615206') assigned by Meta. Obtain it using WHATSAPP\_GET\_PHONE\_NUMBERS action which returns the 'id' field for each phone number.
>
> **status\_filter** `string`
>
> Optional: Filter by specific status. Valid values: 'sent', 'delivered', 'read', 'failed'. Leave empty to monitor all status changes.
>
> #### Payload
>
> **event\_type** `string`
>
> Type of event that occurred
>
> **phone\_number\_id** `string` *required*
>
> The phone number ID that sent the message
>
> **status\_update** `object` *required*
>
> The message status update information
