Description

@call-e/n8n-nodes-calle

This package provides an n8n community node for CALL-E AI-agent phone-call workflows. It lets n8n workflows create CALL-E call tasks, fetch their status, wait for completion, read developer events, and execute published Goals.

n8n is a workflow automation platform. CALL-E provides a Developer API for server-side AI-agent phone-call tasks.

Installation

Install this package as an n8n community node:

npm install @call-e/n8n-nodes-calle

For local development, run:

npm install
npm run build
npm run dev

The development server starts n8n with the CALL-E node linked into the local custom nodes directory.

Credentials

Create a CALL-E API credential in n8n with:

• API Key: Open CALL-E dashboard → API Keys, then select Create API key in the upper-right corner. The value is stored as a password field.
• Base URL: Defaults to https://api.heycall-e.com.
• Request Timeout (MS): Timeout for each individual CALL-E API request.

Do not expose CALL-E API keys in browser code, workflow logs, screenshots, or issue reports.

Operations

The node provides Call, Goal, and Goal Run resources.

Call operations:

• Create: Creates a CALL-E call task.
• Get: Gets one CALL-E call task by ID.
• Create and Wait: Creates a call task, then polls until the task reaches completed, failed, or canceled.
• List Events: Lists developer events for one call task.

Cancel is not included in this release because the current CALL-E Developer API and server SDKs do not expose a cancel call task API.

Goal operations:

• List: Lists published Goals using cursor pagination.
• Get: Gets one published Goal by ID.

Goal Run operations:

• Create: Creates one phone-specific execution of a published Goal.
• Get: Gets one Goal Run by Goal ID and Goal Run ID.
• Create and Wait: Creates a Goal Run, then polls until CALL-E returns a structured result or final error.

Call Parameters

Create and Create and Wait support:

• Phone Number: Required E.164 number, for example +14155550100.
• Task: Required phone agent task boundary and expected outcome.
• Idempotency Key: Required. The default expression is based on the n8n execution ID and item index; override it with a business key when you need duplicate prevention across workflow retries.
• Locale: Optional language and locale hint, for example en-US.
• Region: Optional routing or country/region hint, for example US.
• Metadata: Optional JSON object returned with the call task for business-system correlation.
• Result Schema: Optional JSON object schema for task-level structured output.
• Recipient Result Schema: Optional JSON object schema for recipient-level structured output.
• Webhook URL: Optional callback URL for terminal CALL-E events.

Create and Wait also supports:

• Polling Interval (MS): How often n8n polls CALL-E for the current call status.
• Timeout (MS): Maximum total wait time before the node fails.

Goal Run Parameters

Create and Create and Wait require:

• Goal ID: The public ID of a published CALL-E Goal.
• Phone Number: An authorized E.164 recipient number.
• Idempotency Key: A durable key for exactly one business event. Reuse the same key only to retry the identical Goal Run request.
• Variables: An optional flat JSON object of finite strings, booleans, or numbers accepted by the Goal’s published input schema.

Create and Wait continues after status=completed while both result and error are null; CALL-E may still be persisting the validated result. A timeout does not cancel the provider-side Goal Run. Use Get with the returned Goal Run ID rather than creating another run.

Outputs

The node returns the raw CALL-E API response for the selected operation:

• Create returns the created call task.
• Get returns the current call task.
• Create and Wait returns the final call task after a terminal status.
• List Events returns the CALL-E events response.

If n8n Continue On Fail is enabled, the node returns an item with an error field instead of stopping the workflow.

Safety

Phone calls are real-world side effects. Use this node only when the workflow has explicit user intent to place the call.

Operational safeguards:

• Use E.164 phone numbers.
• Use stable idempotency keys to prevent duplicate call tasks.
• Keep API keys in n8n credentials only.
• Avoid logging full phone numbers or secrets in workflow outputs.
• For recurring reminders, let the n8n workflow or host scheduler manage recurrence. CALL-E should handle one call task per scheduled workflow run.
• Keep workflows inactive until credentials, recipient numbers, task wording, and test paths are reviewed.
• Stop a running n8n execution from the n8n execution view if a call workflow needs cancellation.
• Do not use this node for emergency, medical, legal, or financial advice workflows without an appropriate human-reviewed safety process.

Create and Wait has a node-level timeout. If the timeout expires, the n8n execution fails or returns an error item when Continue On Fail is enabled. A timeout does not guarantee that the provider-side call has been canceled; check CALL-E for the latest call status.

Compatibility

This package is intended for current n8n community node development flows using @n8n/node-cli.

Release

This package is published from this repository through .github/workflows/publish.yml.

To publish a release, make sure package.json and package-lock.json have the target version, then push a matching tag:

git tag v0.1.2
git push origin v0.1.2

The workflow validates that the tag version matches package.json, runs lint, tests, build, and publishes with npm provenance.

For npm Trusted Publishing, configure npm with:

• Repository owner: CALLE-AI
• Repository name: n8n-nodes-calle
• Workflow filename: publish.yml
• Environment: leave blank unless the workflow is later changed to use one

If Trusted Publishing is not configured, add an npm automation token as the GitHub Actions secret NPM_TOKEN.

Resources

• Create or manage CALL-E API keys — select Create API key in the upper-right corner.
• CALL-E API Reference
• n8n community nodes documentation