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

# Zapier Integration

> Send new job matches and proposals from Vollna to other apps with Zapier

Use the [Vollna Zapier app](https://zapier.com/apps/vollna/integrations) to send new job matches and proposals to tools like Google Sheets, Slack, HubSpot, and Notion.

<Note>
  Zapier integration is available with [Agency plan](https://www.vollna.com/pricing) or as paid add-on.
</Note>

## Available triggers

* **New Filter Results**: fires once per filter result — a batch of new jobs found by the selected filter.
* **New Projects for a Filter**: fires once per new job matching the selected filter.
* **New Proposals**: fires when new proposals appear in the selected Upwork organization.

## Step 1: Get your Vollna API token

1. Go to **[Dashboard → Team → API Tokens](https://www.vollna.com/dashboard/team/api-tokens)**.
2. Generate a token (or copy an existing one).

## Step 2: Create a Zap

1. In Zapier, click **Create Zap**.
2. Search for **Vollna** as the trigger app and pick a trigger (e.g. *New Projects for a Filter*).
3. When prompted to connect your account, paste your API token.
4. For a job trigger, select the filter to watch; for **New Proposals**, select the Upwork organization. Then test the trigger — Zapier pulls in recent sample data so you can map fields.
5. Add the action app and map the job or proposal fields.

## Zap templates

Browse the [Vollna page on Zapier](https://zapier.com/apps/vollna/integrations) for ready-made templates — for example, creating HubSpot deals from new Vollna projects.

## Alternative: webhooks

If you prefer instant push delivery instead of Zapier's polling, pair Vollna's [Webhook Notifications](/docs/notifications/webhooks) with the **Webhooks by Zapier** trigger (*Catch Hook*):

1. In Zapier, create a Zap with **Webhooks by Zapier → Catch Hook** and copy the generated URL.
2. In Vollna, go to **Dashboard → Notifications → Webhook → Setup** and paste the URL.
3. Click **Send test request** so Zapier captures the payload structure.

<Note>
  If Webhooks by Zapier isn't available on your Zapier plan, use the native Vollna triggers above instead. The webhook payload contains a `projects` array — add **Looping by Zapier** over the `projects` line items to run actions once per job. See the [webhook field reference](/docs/notifications/webhooks#field-reference).
</Note>

### Proposals & invitations via webhooks

Proposal and invitation events use a separate endpoint with a different payload: create it under **Dashboard → Settings → Developers → Webhooks**, select the `upwork_proposal.*` / `upwork_invitation.*` events you need, and paste the Catch Hook URL. [Team Webhooks](/docs/integrations/webhooks) send one event per request, so there is no array to loop over — map the `data` fields directly.

## Troubleshooting

1. **Connection fails**: regenerate your API token and reconnect; make sure your subscription includes API access.
2. **No sample data on test**: pick a filter that has matched jobs in the last few days — the trigger only returns recent items.
3. **Zap not firing**: polling triggers run on your Zapier plan's polling interval; use the webhook alternative above for instant delivery.