RetellAI

Overview

This node integrates with the RetellAI API to manage phone numbers among other resources. Specifically, for the "Phone Number" resource and the "Delete" operation, it allows users to delete a phone number from their RetellAI account by specifying the phone number in E.164 format. This is useful for managing and cleaning up phone numbers that are no longer needed or valid.

Practical examples include:

• Removing a decommissioned phone number from your RetellAI setup.
• Automating cleanup of phone numbers after campaigns or projects end.
• Managing phone number inventory programmatically within workflows.

Properties

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will confirm whether the deletion was successful or provide error details if it failed.

If an error occurs during execution, the output JSON will contain an error field with the error message.

No binary data output is involved in this operation.

Dependencies

• Requires an active connection to the RetellAI API.
• Needs an API authentication token credential configured in n8n to authorize requests.
• The base URL used for API calls is https://api.retellai.com.
• The node expects the API to accept and return JSON-formatted data.

Troubleshooting

• Common issues:

  • Invalid phone number format: Ensure the phone number is in correct E.164 format (e.g., +14157774444).
  • Authentication errors: Verify that the API key credential is correctly set up and has necessary permissions.
  • Network or API downtime: Check connectivity and RetellAI service status.

• Error messages:

  • Errors returned from the API will be included in the output JSON under an error property.
  • If the node fails due to invalid input or authorization, the error message will indicate the cause.
  • To continue processing other items despite errors, enable the "Continue On Fail" option in the node settings.

Links and References

• RetellAI API Documentation (for detailed API usage and phone number management)
• E.164 Phone Number Format (to understand the required phone number format)