WhatsApp Business

Send messages, manage templates, and interact with customers via WhatsApp.

Detail	Value
Category	Social Media
Base URL	https://graph.facebook.com/v19.0
Authentication	Bearer Token
Endpoints	5
Connector key	whatsapp

Using WhatsApp Business in a workflow

1. Go to Connections and click New Connection.
2. Pick WhatsApp Business from the marketplace.
3. Enter your credentials (see Authentication above for what's expected).
4. In a workflow, drop an API Call node and select this connection.
5. Pick the operation you need from the Operation dropdown — the full list is below.

Available endpoints

Endpoint	Summary
POST /{phoneNumberId}/messages	Send a message
GET /{whatsappBusinessAccountId}/message_templates	List message templates
POST /{whatsappBusinessAccountId}/message_templates	Create a message template
POST /{phoneNumberId}/media	Upload media
GET /{whatsappBusinessAccountId}/phone_numbers	List phone numbers

Each endpoint is documented in full below. Use the outline on the right to jump to one.

POST /{phoneNumberId}/messages

Send a message

Detail	Value
Operation ID	social.sendMessage
Method	POST
Path	/{phoneNumberId}/messages

Parameters

Name	Location	Type	Required
phoneNumberId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your WhatsApp Business connection from the Connection dropdown.
3. In the Operation dropdown, select social.sendMessage.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream WhatsApp Business API reference.

GET /{whatsappBusinessAccountId}/message_templates

List message templates

Detail	Value
Operation ID	social.listTemplates
Method	GET
Path	/{whatsappBusinessAccountId}/message_templates

Parameters

Name	Location	Type	Required
whatsappBusinessAccountId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your WhatsApp Business connection from the Connection dropdown.
3. In the Operation dropdown, select social.listTemplates.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream WhatsApp Business API reference.

POST /{whatsappBusinessAccountId}/message_templates

Create a message template

Detail	Value
Operation ID	social.createTemplate
Method	POST
Path	/{whatsappBusinessAccountId}/message_templates

Parameters

Name	Location	Type	Required
whatsappBusinessAccountId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your WhatsApp Business connection from the Connection dropdown.
3. In the Operation dropdown, select social.createTemplate.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream WhatsApp Business API reference.

POST /{phoneNumberId}/media

Upload media

Detail	Value
Operation ID	social.uploadMedia
Method	POST
Path	/{phoneNumberId}/media

Parameters

Name	Location	Type	Required
phoneNumberId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your WhatsApp Business connection from the Connection dropdown.
3. In the Operation dropdown, select social.uploadMedia.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream WhatsApp Business API reference.

GET /{whatsappBusinessAccountId}/phone_numbers

List phone numbers

Detail	Value
Operation ID	social.listPhoneNumbers
Method	GET
Path	/{whatsappBusinessAccountId}/phone_numbers

Parameters

Name	Location	Type	Required
whatsappBusinessAccountId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your WhatsApp Business connection from the Connection dropdown.
3. In the Operation dropdown, select social.listPhoneNumbers.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream WhatsApp Business API reference.