The API Trigger node lets external systems start a call through this agent programmatically. When you add this node, Voicerix generates a unique URL that you or your team can call from any system — a backend, a CRM, n8n, Zapier, or any other tool.
How it works
- Add an API Trigger node to your agent
- Voicerix generates a unique endpoint URL for this agent
- Your system sends a POST request to that URL with the customer’s phone number
- Voicerix places the call automatically
Trigger URL
Once the node is added, you will see two URLs in the node settings:
If you update and save the agent but do not publish it, the Production URL will still run the old published version. Use the Test URL to verify changes before publishing.
Making a request
You need an API key to authenticate requests. Generate one from Settings in your Voicerix platform.
Send a POST request with your API key and the customer’s phone number:
Initial Context
Use initial_context to pass customer-specific data into the call. You can reference these values in your agent’s prompts in two ways:
{{customer_name}} — shorthand, works directly{{initial_context.customer_name}} — explicit form, same result
Both work. Use whichever feels cleaner in your prompts.
Response
A successful request returns a run ID you can use to track the call:
You can use this ID to fetch the call recording, transcript, and result from Calls History. 
