n8n-nodes-bolnaai

n8n community node for Bolna Voice AI. Create and manage outbound calling agents, place and stop calls, and fetch call executions and transcripts from n8n workflows.

Installation

Follow the n8n community nodes installation guide, using n8n-nodes-bolnaai as the package name.

Credentials

This package uses a single Bolna API credential.

1. Get an API key from your Bolna dashboard.
2. In n8n, create a new Bolna API credential and paste the key into the API Key field.

Nodes

Bolna

• Call: Create (place an outbound call) and Stop (cancel a queued/scheduled call).
• Executions: Get a single execution, get its raw logs, or list executions for an agent within a date range (max 7 days). Supports Return All / Limit pagination.
• Agent: Create, Get, List, Update (a documented subset of patchable fields), Delete, and Stop Calls (cancel all queued calls for an agent).

An agent's tasks and agent_prompts fields are deep and provider-specific, so they're exposed as JSON fields with realistic working defaults. Every write operation also has an Advanced Raw Body (JSON) field; its keys override the structured fields, so you can use it for any Bolna field not yet exposed in the UI.

Bolna Trigger

Receives Bolna's call execution-status webhook. Bolna has no webhook-registration API, so after adding this node to a workflow, copy its webhook URL into the target Agent's Webhook URL field (via this package's Agent node or the Bolna dashboard's Analytics tab). The node supports an optional status filter and a shared-secret header check for verifying incoming requests, which is recommended. Bolna doesn't document an HMAC or signed-webhook scheme, so this is a manually agreed header value, not cryptographic signature verification. For additional hardening, Bolna also publishes a webhook source IP in their dashboard under Analytics settings, which you can optionally whitelist.

Example usage

1. Place a call. Bolna node, Resource: Call, Operation: Create. Set Agent ID and Recipient Phone Number.
2. React to call completion. Bolna Trigger node, webhook URL set as the Agent's Webhook URL, filtered by status completed. Branch on the incoming status, transcript, and total_cost fields.
3. Poll a call's result. Bolna node, Resource: Executions, Operation: Get. Set Execution ID from the Call Create response.

Scope

This package covers Bolna's voice-calling and calling-agent API surface only. Knowledgebases, Providers, Sub-accounts, SIP Trunks, Dispositions, Violations, Voice/TTS provider discovery, and Phone Numbers are not covered.

Links

• Bolna API reference
• Bolna webhook guide