WhatsApp Business
Communication Live verified

WhatsApp Business Connector

WhatsApp Business Platform (Cloud API) — Meta's official WhatsApp API (BYOK: your Meta app + System User token). Free-form sends within the 24h customer-service window, template sends outside it, media up/download, business profile, and webhook receive primitives. Personal WhatsApp accounts have no API — for human-in-the-loop links use the 'whatsapp' connector.

$pip install "toolsconnector[whatsapp_business]"
64
Actions
Communication
Category
Free
Apache 2.0

All 64 Actions

Action Description Parameters Returns
block_users ⚠Block users from messaging this numbernumbersWhatsAppBlockResult
create_flowCreate a Flow (in-chat form); returns it in DRAFTname, categories  [flow_json, endpoint_uri, clone_flow_id, publish]WhatsAppFlowMutationResult
create_qr_codeCreate a managed QR code / short linkprefilled_message  [image_format]WhatsAppQRCode
create_templateCreate a message template (goes to Meta review)name, language, category, components  [parameter_format]WhatsAppTemplateCreateResult
debug_tokenInspect a token: validity, scopes, and the WABA ids it can reach[input_token, app_id]WhatsAppTokenInfo
delete_flow ⚠Delete a draft Flowflow_idWhatsAppSuccessResult
delete_media ⚠Delete an uploaded media itemmedia_idWhatsAppSuccessResult
delete_qr_code ⚠Delete a managed QR codecodeWhatsAppSuccessResult
delete_template ⚠Delete a template by name (all languages)name  [template_id]WhatsAppSuccessResult
deprecate_flow ⚠Deprecate a published Flowflow_idWhatsAppSuccessResult
deregister_phone ⚠Deregister the number from Cloud APIWhatsAppSuccessResult
download_mediaDownload media content (handles the 5-minute URL dance)media_idWhatsAppMediaContent
edit_template ⚠Edit a template's components or categorytemplate_id  [components, category]WhatsAppSuccessResult
enable_template_analytics ⚠Enable template analytics on the WABAWhatsAppSuccessResult
exchange_codeExchange an Embedded Signup code for a customer access tokencode  [app_id]WhatsAppTokenExchange
get_business_profileGet the business profile shown in the chat headerWhatsAppBusinessProfile
get_flowGet a Flow's status, categories, and validation errorsflow_id  [include_preview]WhatsAppFlow
get_marketing_eligibilityCheck whether the WABA can use the Marketing Messages APIWhatsAppMarketingEligibility
get_media_infoGet a media item's short-lived download URLmedia_idWhatsAppMediaInfo
get_messaging_analyticsGet message-volume analyticsstart, end  [granularity, phone_numbers]dict
get_phone_numberGet this number's quality, limits, and name statusWhatsAppPhoneNumber
get_pricing_analyticsGet per-message pricing/cost analyticsstart, end  [granularity, metric_types, dimensions]dict
get_templateGet one template by idtemplate_idWhatsAppTemplate
get_template_analyticsGet per-template analytics (opt-in required)template_ids, start, end  [metric_types]dict
get_wabaGet the WhatsApp Business Account nodeWhatsAppWABA
list_blocked_usersList blocked users[limit, after]dict
list_flow_assetsList a Flow's assets (its Flow JSON download URL)flow_idlist
list_flowsList Flows on the WhatsApp Business Account[limit, after]PaginatedList[WhatsAppFlow]
list_phone_numbersList all phone numbers on the WhatsApp Business Account[limit, after]PaginatedList[WhatsAppPhoneNumber]
list_qr_codesList managed QR codes[code]list
list_subscribed_appsList apps subscribed to the WABA's webhooksdict
list_templatesList message templates with status and quality[status, category, language, limit, after]PaginatedList[WhatsAppTemplate]
mark_as_readMark a received message as read (blue ticks)message_idWhatsAppSuccessResult
publish_flow ⚠Publish a Flow so it can be sentflow_idWhatsAppSuccessResult
register_phone ⚠Register the number for Cloud API messagingpin  [data_localization_region]WhatsAppSuccessResult
request_verification_code ⚠Request a phone verification code (SMS or voice)[code_method, language]WhatsAppSuccessResult
send_audioSend an audio clip or voice note (24h window)to  [audio_id, audio_url, reply_to, tracking_data]WhatsAppSendResult
send_contactsSend contact cards (24h window)to, contacts  [reply_to, tracking_data]WhatsAppSendResult
send_cta_urlSend a call-to-action URL button (24h window)to, body, display_text, url  [header_text, footer_text, reply_to, tracking_data]WhatsAppSendResult
send_documentSend a document (24h window)to  [document_id, document_url, caption, filename, reply_to, tracking_data]WhatsAppSendResult
send_flowSend a Flow (in-chat form) to a userto, flow_cta, body  [flow_id, flow_name, screen, data, flow_token, flow_action, mode, header_text, footer_text, tracking_data]WhatsAppSendResult
send_imageSend an image (24h window)to  [image_id, image_url, caption, reply_to, tracking_data]WhatsAppSendResult
send_interactiveSend a raw interactive payload (flows, products, address)to, interactive  [reply_to, tracking_data]WhatsAppSendResult
send_interactive_buttonsSend up to 3 tappable reply buttons (24h window)to, body, buttons  [header_text, footer_text, reply_to, tracking_data]WhatsAppSendResult
send_interactive_listSend a selectable list menu (24h window)to, body, button_text, sections  [header_text, footer_text, reply_to, tracking_data]WhatsAppSendResult
send_locationSend a location pin (24h window)to, latitude, longitude  [name, address, reply_to, tracking_data]WhatsAppSendResult
send_location_requestAsk the user to share their location (24h window)to, body  [reply_to]WhatsAppSendResult
send_marketing_messageSend a marketing template via the Marketing Messages APIto, template_name  [language_code, components, message_activity_sharing, tracking_data]WhatsAppSendResult
send_reactionReact to a message with an emojito, message_id  [emoji]WhatsAppSendResult
send_stickerSend a sticker (24h window)to  [sticker_id, sticker_url, reply_to, tracking_data]WhatsAppSendResult
send_templateSend an approved template (works outside the 24h window)to, template_name  [language_code, components, tracking_data]WhatsAppSendResult
send_textSend a WhatsApp text message (24h window)to, body  [preview_url, reply_to, tracking_data]WhatsAppSendResult
send_typing_indicatorShow a typing indicator in the chatmessage_idWhatsAppSuccessResult
send_videoSend a video (24h window)to  [video_id, video_url, caption, reply_to, tracking_data]WhatsAppSendResult
set_app_webhook ⚠Configure the app-level webhook callback via APIapp_id, callback_url, verify_token  [fields]WhatsAppSuccessResult
set_two_step_pin ⚠Set the two-step verification PINpinWhatsAppSuccessResult
subscribe_appSubscribe this app to the WABA's webhooks[override_callback_uri, verify_token]WhatsAppSuccessResult
unblock_users ⚠Unblock previously blocked usersnumbersWhatsAppBlockResult
update_business_profile ⚠Update the business profile[about, address, description, email, websites, vertical]WhatsAppSuccessResult
update_flow ⚠Update a Flow's metadataflow_id  [name, categories, endpoint_uri]WhatsAppSuccessResult
update_qr_code ⚠Update a managed QR code's prefilled messagecode, prefilled_messageWhatsAppQRCode
upload_flow_jsonUpload the Flow JSON that defines the form's screensflow_id, flow_jsonWhatsAppFlowMutationResult
upload_mediaUpload media, returns a reusable media id (30 days)content_base64, mime_type  [filename]WhatsAppUploadResult
verify_code ⚠Submit the phone verification codecodeWhatsAppSuccessResult
Open Interactive Docs & Playground →

Full schema explorer, code generation, and live API testing