> ## 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.

# Make Integration

> Send job alerts, proposals and invitations from Vollna to Make scenarios

Vollna sends two kinds of webhooks to [Make](https://www.make.com) (formerly Integromat). Set up the one you need, or both.

| What Make receives | Where you set it up in Vollna | One request carries |
| - | - | - |
| [Job alerts](#job-alerts) | **Notifications → Add notification → Webhook** | New jobs from your filters, in a `projects` array |
| [Proposals and invitations](#proposals-and-invitations) | **Settings → Developers → Webhooks** | One proposal or invitation event |

The two payloads differ, so give each one its own scenario and its own Custom webhook.

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

## Job alerts

### Step 1: Create a webhook in Make

1. Create a new scenario.
2. Add the **Webhooks** app as the first module and choose **Custom webhook**.
3. Click **Add**, name the webhook (for example "Vollna job alerts"), and click **Save**.
4. Copy the webhook URL. Make now waits for the first request to learn the fields.

### Step 2: Add the notification in Vollna

1. Go to **Dashboard → Notifications** and click **Add notification**.
2. Pick **Webhook** and paste the Make 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, and Make learns the fields from them.
5. Click **Add notification**.

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

One request can carry several new jobs. To handle each job on its own:

1. Add an **Iterator** module after the webhook.
2. Set its **Array** field to `projects[]`.
3. Add your destination module after the Iterator 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 webhook in Make

Create a new scenario with another **Custom webhook** (for example "Vollna proposals") 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 Make 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** while the Make webhook waits for data. Vollna sends your newest proposal, or your newest invitation if you picked only invitation events, and Make learns the fields from it.
5. Click **Create Webhook**.

### Step 3: Map the event

One request carries one event, so this scenario needs no Iterator. Map `event`, `timestamp` and the fields under `data`, such as `data.jobDetails.title`, `data.isViewed` and `data.connects`.

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

## Troubleshooting

1. **Make shows "Not determined" or the wrong fields.** Click **Redetermine data structure** in Make, then send the test from Vollna again while the module listens.
2. **Make 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. When your first proposal syncs, click **Redetermine data structure** and send the test again.
3. **The scenario doesn't run.** Turn the scenario **ON** with the scheduling toggle in the bottom left of the scenario editor.
4. **Only one job arrives per run.** Point the Iterator's array field at `projects[]`, not at a single project.


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