> ## 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 job alerts, proposals and invitations from Vollna to other apps with Zapier

Connect Vollna to [Zapier](https://zapier.com) in one of three ways:

| What Zapier receives | Where you set it up in Vollna | Zapier trigger |
| - | - | - |
| [Job alerts](#job-alerts) | **Notifications → Add notification → Webhook** | **Webhooks by Zapier → Catch Hook** |
| [Proposals and invitations](#proposals-and-invitations) | **Settings → Developers → Webhooks** | **Webhooks by Zapier → Catch Hook** |
| [New jobs and proposals, without webhooks](#vollna-app-triggers) | **Settings → Developers → API Tokens** | The Vollna app |

Webhooks reach Zapier the moment Vollna sends them. **Webhooks by Zapier** needs a paid Zapier plan. The Vollna app works on any Zapier plan, but Zapier checks it on your plan's polling interval, and it has no trigger for invitations.

> [!NOTE]
>
> Webhooks and API access are available on [higher plans](https://www.vollna.com/pricing) or as a paid add-on.

## Job alerts

### Step 1: Create a Catch Hook

1. In Zapier, click **Create Zap**.
2. Pick **Webhooks by Zapier** as the trigger app and **Catch Hook** as the event.
3. Copy the webhook URL.

### Step 2: Add the notification in Vollna

1. Go to **Dashboard → Notifications** and click **Add notification**.
2. Pick **Webhook** and paste the Zapier URL into **URL**.
3. Pick the filters that should send jobs.
4. Click **Send test**. Vollna sends up to 3 recent jobs from those filters.
5. Click **Add notification**.

### Step 3: Run each job through the Zap

1. In Zapier, test the trigger. It shows the request Vollna sent.
2. One request can carry several new jobs in its `projects` array. Add **Looping by Zapier** and loop over the `projects` line items.
3. Add your action inside the loop and map fields such as `title`, `url`, `budget` and `client_details`.

The [job alert field reference](https://www.vollna.com/docs/notifications/webhooks.md#field-reference) lists every field.

## Proposals and invitations

### Step 1: Create a second Catch Hook

Create a new Zap with **Webhooks by Zapier → Catch Hook** and copy its URL.

### Step 2: Add the endpoint in Vollna

1. Go to **Dashboard → Settings → Developers → Webhooks** and click **Add Endpoint**.
2. Paste the Zapier URL into **Webhook URL**.
3. Under **Events to receive**, tick the events you need. **Proposal Status Changed** also lets you pick which statuses send an event.
4. Click **Send Test Request**. Vollna sends your newest proposal, or your newest invitation if you picked only invitation events.
5. Click **Create Webhook**.

### Step 3: Map the event

In Zapier, test the trigger. It shows the request Vollna sent, with the event `webhook.test`.

One request carries one event, so this Zap needs no loop. Map `event`, `timestamp` and the fields under `data`. Zapier lists nested fields with spaces, such as **Data Job Details Title** for `data.jobDetails.title`.

The [Team Webhooks payload](https://www.vollna.com/docs/integrations/webhooks.md#payload-format) shows every field.

## Vollna app triggers

The [Vollna Zapier app](https://zapier.com/apps/vollna/integrations) reads your data through the Vollna API. It has three 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.

To set it up:

1. Go to **[Dashboard → Settings → Developers → API Tokens](https://www.vollna.com/dashboard/team/api-tokens)** and generate a token, or copy an existing one.
2. In Zapier, create a Zap, search for **Vollna** as the trigger app, and pick a trigger.
3. When Zapier asks you to connect your account, paste the API token.
4. Select the filter to watch, or the Upwork organization for **New Proposals**. Test the trigger, and Zapier pulls in recent items so you can map fields.
5. Add the action app and map the job or proposal fields.

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

## Troubleshooting

1. **The Vollna app won't connect.** Generate a new API token and reconnect. Check that your subscription includes API access.
2. **A Vollna app trigger finds no sample data.** Pick a filter that matched jobs in the last few days. The trigger returns recent items only.
3. **The Zap runs late.** Vollna app triggers run on your Zapier plan's polling interval. Use a webhook for instant delivery.
4. **Zapier shows only `test`, `message` and `webhook_url` under `data`.** You have no proposals or invitations in Vollna yet, so the test carries a test message. Test the trigger again after your first proposal syncs.


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