RetellAI icon

RetellAI

Interact with RetellAI API

Actions21

Overview

This node integrates with the RetellAI API to manage phone numbers, specifically allowing users to create new phone numbers within their RetellAI account. It is useful in scenarios where automated provisioning of phone numbers is needed, such as setting up call centers, assigning numbers to agents, or managing telephony resources programmatically.

For example, a user can create a new phone number with a specific area code and optionally assign it to inbound or outbound agents or give it a nickname for easier identification.

Properties

Name Meaning
Area Code The 3-digit integer area code for the phone number to obtain.
Additional Fields Optional extra settings for the phone number:
- Inbound Agent: Agent ID for inbound calls
- Outbound Agent: Agent ID for outbound calls
- Nickname: A friendly name for the phone number

Output

The node outputs JSON data representing the created phone number object returned by the RetellAI API. This typically includes details such as the phone number itself, associated agent IDs if any, nickname, and other metadata provided by the API response.

No binary data output is indicated.

Dependencies

  • Requires an active connection to the RetellAI API.
  • Needs an API authentication token credential configured in n8n to authorize requests.
  • The node uses the base URL https://api.retellai.com for all API calls.

Troubleshooting

  • Invalid Area Code: If the area code is not a valid 3-digit integer or not supported by RetellAI, the API may return an error. Ensure the area code is correctly formatted and available.
  • Agent ID Errors: Providing invalid or non-existent agent IDs for inbound or outbound agents will likely cause API errors. Verify agent IDs before use.
  • Authentication Failures: Missing or incorrect API credentials will prevent the node from connecting to RetellAI. Confirm that the API key/token is correctly set up in n8n.
  • API Rate Limits or Downtime: If the RetellAI service is unavailable or rate limits are exceeded, the node will throw errors. Retry after some time or check service status.

Links and References

Discussion