Actions36
- Message Actions
- Media Actions
- Conversation Actions
- Agent Actions
- Template Actions
- Contact Actions
- Funnel Actions
Contact → Bulk
AI-generatedSummary
Runs one bulk action (create, update, delete, tag or untag) on many Whaapy contacts with a single POST to the /contacts/v1/bulk endpoint.
Inputs
- Bulk Operation (required) — Action to apply: create, update, delete, tag or untag. Sent as
operationin the request body. Defaults to create. - Contacts Data (required) — JSON array of contact objects or contact IDs, depending on the bulk operation. A string value is parsed as JSON, and an expression that returns an array is passed as is. Sent as
contacts. Defaults to []. - Operation Data — JSON object with extra data for the operation, for example the tags to apply or the fields to change. Sent as
data. Defaults to {}. The node doesn't say which keys the API expects.
Output shape
One output item per input item, containing the raw JSON response from the Whaapy bulk endpoint.
The response structure is defined by the API and isn't visible in the node. The node does not split results per contact. Each input item sends its own request. If the JSON is invalid or the request fails, the node throws. With Continue On Fail enabled, it returns an item of the form {error: message} instead. An empty response produces no output item.
Examples
Example 1: Tag a batch of contacts as 'vip'
Bulk Operation=tag; Contacts Data=["id1","id2"]; Operation Data={"tags":["vip"]} (the tags key is an assumption, so check the Whaapy API docs).
Example 2: Import new contacts from a spreadsheet
Bulk Operation=create; Contacts Data={{ JSON.stringify($input.all().map(i => i.json)) }}; Operation Data left as {}.