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

# Triggers

> Automatically add contacts to your Callers dashboard when actions occur in your connected apps. No manual uploads or complex API setup required — just a few clicks.

Triggers automatically add contacts to your Callers dashboard whenever specific actions occur in apps you've connected through the App Center. Skip manual uploads and complex API configurations — set everything up with just a few clicks.

### Setting Up a Trigger

To get started, go to your campaign settings and open the **Workflow** tab. The trigger block appears as the first element in your workflow.

<Frame caption="Trigger block in the workflow">
  <img src="https://mintcdn.com/voxiaai/Ivxd2bGUdpPdB9yk/images/documentation/integrations/triggers-workflow.png?fit=max&auto=format&n=Ivxd2bGUdpPdB9yk&q=85&s=4431ac42bec2f729ec58c422cfa5d605" alt="trigger workflow" style={{borderRadius: '10px'}} width="3786" height="1436" data-path="images/documentation/integrations/triggers-workflow.png" />
</Frame>

Click the trigger block to see a menu of all your connected apps with available triggers. Keep in mind that not all apps support triggers.

<Frame caption="Selecting a trigger from connected apps">
  <img src="https://mintcdn.com/voxiaai/jiZwS00F3vhCINL8/images/documentation/integrations/triggers-choose.png?fit=max&auto=format&n=jiZwS00F3vhCINL8&q=85&s=519026d52edc92f8991065e356876474" alt="trigger choose" style={{borderRadius: '10px'}} width="3413" height="1569" data-path="images/documentation/integrations/triggers-choose.png" />
</Frame>

### Trigger Types

Triggers come in two types: **instant** and **scheduled**. Instant triggers add contacts as soon as the action fires, while scheduled triggers check for new data at regular intervals (typically every 5 minutes). Both types are configured the same way.

Each trigger has a label indicating its type — look for the **Instant** label with a lightning bolt icon or the **Scheduled** label with a clock icon next to each trigger name.

<Frame caption="Trigger types">
  <img src="https://mintcdn.com/voxiaai/Ivxd2bGUdpPdB9yk/images/documentation/integrations/triggers-instant.png?fit=max&auto=format&n=Ivxd2bGUdpPdB9yk&q=85&s=f8e1c8b98c7591605ef42084dd97aa8e" alt="trigger instant" style={{borderRadius: '10px'}} width="3312" height="1506" data-path="images/documentation/integrations/triggers-instant.png" />
</Frame>

### Example: Setting Up a HubSpot Trigger

Let's set up a HubSpot trigger as an example. HubSpot uses scheduled triggers, so we'll configure the **New Contact** trigger to automatically add contacts whenever they're created in HubSpot.

<Frame caption="HubSpot triggers">
  <img src="https://mintcdn.com/voxiaai/Ivxd2bGUdpPdB9yk/images/documentation/integrations/triggers-scheduled.png?fit=max&auto=format&n=Ivxd2bGUdpPdB9yk&q=85&s=192d6d8019b51c19f307f0993b621169" alt="trigger scheduled" style={{borderRadius: '10px'}} width="3324" height="1535" data-path="images/documentation/integrations/triggers-scheduled.png" />
</Frame>

Once you've selected the trigger, click **Load Test Data** to pull in sample data. Make sure you have at least one contact in your HubSpot account for this to work.

<Frame caption="Loading test data for the trigger">
  <img src="https://mintcdn.com/voxiaai/Ivxd2bGUdpPdB9yk/images/documentation/integrations/triggers-test-data.png?fit=max&auto=format&n=Ivxd2bGUdpPdB9yk&q=85&s=ec18866d64b9ce80bc0e370d3d051da7" alt="trigger test data" style={{borderRadius: '10px'}} width="3326" height="1500" data-path="images/documentation/integrations/triggers-test-data.png" />
</Frame>

When the test contact loads successfully, you'll see a success message in the right panel showing all the fields the trigger can retrieve. Click **Next** to continue.

<Frame caption="Test contact loaded successfully">
  <img src="https://mintcdn.com/voxiaai/Ivxd2bGUdpPdB9yk/images/documentation/integrations/triggers-test-contact.png?fit=max&auto=format&n=Ivxd2bGUdpPdB9yk&q=85&s=4b71a14bf422a5baccb7dea0bef2d496" alt="trigger test contact" style={{borderRadius: '10px'}} width="3327" height="1491" data-path="images/documentation/integrations/triggers-test-contact.png" />
</Frame>

### Mapping Contact Variables

In the next window, map your AI script's contact variables to the fields coming from the trigger. Click **Choose** next to each variable and select the matching field from the trigger data.

<Note>
  **Important:** Make sure phone numbers are in **E.164** format — they must start with a plus sign and include the country code (for example, `+14155552671`).
</Note>

<Frame caption="Mapping contact variables">
  <img src="https://mintcdn.com/voxiaai/Ivxd2bGUdpPdB9yk/images/documentation/integrations/triggers-mapping.png?fit=max&auto=format&n=Ivxd2bGUdpPdB9yk&q=85&s=cd87198f5960c8919d4b977ecc7a1234" alt="trigger mapping" style={{borderRadius: '10px'}} width="3416" height="1668" data-path="images/documentation/integrations/triggers-mapping.png" />
</Frame>

Once you've finished mapping all variables, click **Done**. Your trigger is now active and ready to use.

<Frame caption="Trigger configuration complete">
  <img src="https://mintcdn.com/voxiaai/Ivxd2bGUdpPdB9yk/images/documentation/integrations/triggers-finished-mapping.png?fit=max&auto=format&n=Ivxd2bGUdpPdB9yk&q=85&s=9b5ffb903d10fe15fefc30ac366a9c7f" alt="trigger finished mapping" style={{borderRadius: '10px'}} width="3370" height="1572" data-path="images/documentation/integrations/triggers-finished-mapping.png" />
</Frame>

### How It Works

Once your trigger is set up, new contacts from your CRM are automatically added to your Callers dashboard. For instant triggers, this happens immediately. For scheduled triggers, the system checks for new contacts every few minutes. All new contacts will be called during your campaign's business hours according to your settings.
