> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Triggering a VoiceAgent Call from Zapier

> Trigger CloudTalk VoiceAgent calls via Zapier with Webhook step. Automate calls, pass data, and customize - no coding needed.

> [!NOTE]
>
> This guide walks you through how to trigger a **CloudTalk VoiceAgent** call using **Zapier** and the **Webhooks by Zapier** app. This lets you launch automated voice calls based on real-time events in your tools - without writing any code.

**User level:**

* Admin

***

## CloudTalk VoiceAgents in Zapier

Zapier connects your favorite tools and automates tasks between them. By Zapier helps you connect your tools and automate tasks between them. When you connect it with **CloudTalk VoiceAgent**, you can trigger voice calls based on live data from tools like CRMs, forms, or helpdesk systems. This allows you to confirm appointments, follow up on leads, or send voice reminders using the data you already collect. It brings voice automation directly into your existing workflows.

To trigger a **VoiceAgent call from Zapier**, use the [Webhooks app](https://zapier.com/apps/webhook/integrations) to send an API request to the [CloudTalk VoiceAgent endpoint](https://help.cloudtalk.io/api-reference/voiceagent/initiate-voiceagent-call.md) as one of the steps in your Zap.

### Prerequisites

Before setting up the Webhook Custom Request in Zapier, make sure you have:

* *CloudTalk API Credentials*

  * Go to **CloudTalk Dashboard → Settings → API Keys**

  * Copy both the **API Key ID** and **API Key Secret**

* *VoiceAgent ID*

  * VoiceAgent ID can be retrieved from Cloudtalk **Dashboard > AI Voice Agents**

  ![](https://mintcdn.com/cloudtalk/g8s2E4Yk8cWS5656/images/help-center/articles/11831224/66af489dee4a-vaid.png?fit=max\&auto=format\&n=g8s2E4Yk8cWS5656\&q=85\&s=067b7d34380535b6ce267b80b228d17a)

### Setup Instructions

Follow these steps to set up trigger a VoiceAgent call from Zapier:

1. In the Zap of your choice, add an **Action** step and choose **Webhooks by Zapier.**

2. Choose **Custom Request** as the action event.

3. For **Method** select POST

4. For API Endpoint use this **URL**:\
   [`https://api.cloudtalk.io/v1/voice-agent/calls`](https://api.cloudtalk.io/v1/voice-agent/calls)

5. In Data configure body of request according to [API documentation](https://help.cloudtalk.io/api-reference/voiceagent/initiate-voiceagent-call.md)

   * Create a JSON payload using the following format:

     ```json theme={"system"}
     {
     "call_number": "#{{phone_number}}",
     "voice_agent_id": "#{{voice_agent_id}}",
     "call_properties": {
     "system_prompt": {
     "variables": {
     "contact_name": "#{{name}}"
     }
     },
     "output": {
     "variables": {
     "custom_field": "value"
     }
     }
     }
     }
     ```

   * Replace the variables (`#{{...}}`) with data from earlier steps in your scenario.

   * In `call_number`, insert a reference to the phone number (e.164) to be called, extracted from previous steps.

   * In `voice_agent_id`, insert the ID of the VoiceAgent obtained from the CloudTalk Dashboard.

   * If necessary, configure `call_properties`, where:

     1. Data in `call_properties.system_prompt.variables` includes request-specific information the VoiceAgent should use during the call (e.g. the contact's name).

     2. Data in `call_properties.output.variables` defines the values VoiceAgent should pass to the external endpoint after the call, in addition to information extracted during the conversation.

   ![](https://mintcdn.com/cloudtalk/g8s2E4Yk8cWS5656/images/help-center/articles/11831224/bdcbf8b7ba06-image.png?fit=max\&auto=format\&n=g8s2E4Yk8cWS5656\&q=85\&s=1ac248ff9179fe93b91e2045d354e3b6)

> [!WARNING]
>
> 📘 **Want to go deeper?** Learn how System prompt variables and Output variables shape your VoiceAgent's behavior in [this dedicated article](https://help.cloudtalk.io/en/articles/11401649-voiceagents-for-outbound-calls.md#h_91064c3683)!

6. In the **Headers** field, add the header `"Content-Type": "application/json"`
7. Set up **Basic Authentication** using your **API Key ID** as the username and **API Key Secret** as the password, both taken from the CloudTalk Dashboard.
8. Click **Continue**, and if you'd like to verify the setup, use **Test Step** to send a test call.

> [!NOTE]
>
> ⚠️ **Caution:** Testing the step will trigger a real VoiceAgent call. Make sure the `call_number` used during testing is a number you intend to call at this stage.

**You’re all set!** 🚀 Your setup is complete and ready to start triggering VoiceAgent calls with ease. Let the automation begin!

> [!NOTE]
>
> **💡 API Limits to Keep in Mind**
>
> *To avoid failures or throttling, make sure your Make scenario handles call distribution carefully. Use delays, queues, or scheduling logic where needed, as the standard API Rate limit (60 requests per minute) applies to VoiceAgent endpoint.*

***

*Need help or have a question?* Just reach out through our [Support portal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — we’re here for you.


## Related topics

- [Triggering a VoiceAgent Call from Freshdesk](https://help.cloudtalk.io/en/articles/15457387-triggering-a-voiceagent-call-from-freshdesk.md)
- [Triggering a VoiceAgent Call from Zendesk](https://help.cloudtalk.io/en/articles/15934846-triggering-a-voiceagent-call-from-zendesk.md)
- [Triggering a VoiceAgent Call from Freshservice](https://help.cloudtalk.io/en/articles/15502021-triggering-a-voiceagent-call-from-freshservice.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.