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

# Zapier

> Zapier can help you automate tasks and build workflows between otherwise incompatible apps through automated connections called Zaps — set up in minutes with no coding.

<Info>
  The Zapier integration is available for **advanced and business users.**
</Info>

## **How it works**

Zapier integrates with 6000+ apps including Google Sheets, Airtable, Mailchimp, Notion, Salesforce, Teamleader, and many more. This makes Zapier a popular tool for automating workflows between otherwise incompatible apps.

Users can set up multi-step Zaps that automatically trigger a sequence of actions after one initial trigger event, such as a new Watermelon conversation.

### **1. Connect to Zapier**

Here's how to get started with syncing your Watermelon conversations to other apps using Zapier.

First, create a Zapier account (for free) if you don't already have one. Then, go to the `Integrations` tab.

<Frame>
  <img src="https://mintcdn.com/watermelon/CwnSFOoPBQM5KdBq/images/integrations/zapier/zapier-integration-menu.png?fit=max&auto=format&n=CwnSFOoPBQM5KdBq&q=85&s=3cb0d9af2d57bc812e7ebfa312e7a4bf" alt="Zapier Integration Menu" width="2938" height="1390" data-path="images/integrations/zapier/zapier-integration-menu.png" />
</Frame>

You’ll be prompted to log into your Zapier account.

### **2. Build your own Zap or use a template**

You can either create your automation from scratch or head to the [**Watermelon integration page**](https://zapier.com/apps/watermelon/integrations) on Zapier to explore ready-made templates and different integrations you can set up.

<Frame>
  <img src="https://mintcdn.com/watermelon/V0Btc937jLqMJttP/images/integrations/zapier/zapier-integration-page.png?fit=max&auto=format&n=V0Btc937jLqMJttP&q=85&s=4be8f6a61fbf5408b1b3b19c01361392" alt="Zapier Integration Page Pn" width="3000" height="1750" data-path="images/integrations/zapier/zapier-integration-page.png" />
</Frame>

### **3. Create a trigger**

If you’re building your own Zap from scratch, click the `+ Create` button in your sidebar, then select `Zaps`.

<Frame>
  <img src="https://mintcdn.com/watermelon/V0Btc937jLqMJttP/images/integrations/zapier/zapier-create-button.png?fit=max&auto=format&n=V0Btc937jLqMJttP&q=85&s=8c4300df30e4824c9ec5a413f1f9b12b" alt="Zapier Create Button Pn" width="3002" height="1676" data-path="images/integrations/zapier/zapier-create-button.png" />
</Frame>

A Zap is made up of a trigger and an action. A trigger is an event that starts a Zap; for Watermelon, the trigger events are:

| Trigger event                  | Triggers when                                                |
| ------------------------------ | ------------------------------------------------------------ |
| Handover conversation to agent | A conversation is handed over from AI agent to a human agent |
| Handover conversation to team  | A conversation is handed over from AI agent to a team        |
| New contact                    | A contact has been created                                   |
| New conversation               | A conversation has been created                              |
| Updated contact                | A contact has been updated                                   |

Click on `1. Trigger` to start creating your automation trigger.

<Frame>
  <img src="https://mintcdn.com/watermelon/V0Btc937jLqMJttP/images/integrations/zapier/zapier-trigger.png?fit=max&auto=format&n=V0Btc937jLqMJttP&q=85&s=a8b908ddcb9ded2404da08b5ea46cb8b" alt="Zapier Trigger Pn" width="3100" height="1714" data-path="images/integrations/zapier/zapier-trigger.png" />
</Frame>

Then, search for ‘Watermelon’ and click on it.

<Frame>
  <img src="https://mintcdn.com/watermelon/V0Btc937jLqMJttP/images/integrations/zapier/zapier-search-results.png?fit=max&auto=format&n=V0Btc937jLqMJttP&q=85&s=9fec21bbd93e5b642f30c00ba3c4123a" alt="Zapier Search Results Pn" width="3098" height="1708" data-path="images/integrations/zapier/zapier-search-results.png" />
</Frame>

In the `Event` dropdown, select your desired trigger.

<Frame>
  <img src="https://mintcdn.com/watermelon/V0Btc937jLqMJttP/images/integrations/zapier/zapier-trigger-events.png?fit=max&auto=format&n=V0Btc937jLqMJttP&q=85&s=c8569a4f0a17ae94cc1f7a5e53708190" alt="Zapier Trigger Events Pn" width="3098" height="1708" data-path="images/integrations/zapier/zapier-trigger-events.png" />
</Frame>

In the `Account` section, click `Sign in` to connect your Watermelon account. You’ll be prompted to fill in your API key and secret to authorize Zapier. You can create an API-key following [this guide](/api-reference/api-keys).

<Frame>
  <img src="https://mintcdn.com/watermelon/2oQVNKq2_kJvRRgW/images/integrations/zapier/connect-watermelon-zapier.png?fit=max&auto=format&n=2oQVNKq2_kJvRRgW&q=85&s=9f7c1a342c43f8adc52281a0ae4d1bb6" alt="Connect Watermelon Zapier Pn" width="3094" height="1716" data-path="images/integrations/zapier/connect-watermelon-zapier.png" />
</Frame>

In the `Test` section, you can **test the trigger**.

<Frame>
  <img src="https://mintcdn.com/watermelon/V0Btc937jLqMJttP/images/integrations/zapier/test-trigger-zapier.png?fit=max&auto=format&n=V0Btc937jLqMJttP&q=85&s=45576cc4de30fd9b7efcaa729bf3a970" alt="Test Trigger Zapier Pn" width="3100" height="1712" data-path="images/integrations/zapier/test-trigger-zapier.png" />
</Frame>

Your test conversation data will look like this:

<Frame>
  <img src="https://mintcdn.com/watermelon/V0Btc937jLqMJttP/images/integrations/zapier/test-data.png?fit=max&auto=format&n=V0Btc937jLqMJttP&q=85&s=66ee4d2cb157ecbd7e299cd225f18dca" alt="Test Data Pn" width="794" height="1518" data-path="images/integrations/zapier/test-data.png" />
</Frame>

Next, click the `Continue with selected record` button.

### **4. Choose an action**

Now, you’ll have to add an action — an event a Zap performs after it's triggered, like notifying your team in Slack, sending a follow-up email, or adding a new record to your Airtable base.

**Choose the action app you want to connect with** and connect your account. If you already have an account connected to Zapier for the action app, select it from the account menu.

<Frame>
  <img src="https://mintcdn.com/watermelon/2oQVNKq2_kJvRRgW/images/integrations/zapier/action-google-sheet.png?fit=max&auto=format&n=2oQVNKq2_kJvRRgW&q=85&s=4248ebc53fc2d3356a4c468435456f45" alt="Action Google Sheet Pn" width="3092" height="1712" data-path="images/integrations/zapier/action-google-sheet.png" />
</Frame>

From the `Event` dropdown, choose the action you want Zapier to perform. For example, we want Zapier to create a new spreadsheet row anytimea new conversation is started.

In the `Account` section, you’ll be prompted to log in to the app you selected and authorize Zapier to connect with it.

### **5. Customize action**

Next, **customize the data** that you want to send over to your action app. In this step, you'll see dropdown menus and/or fields to fill in.

In this example, we will select where in the Google spreadsheet we want Zapier to create a row and which conversation data we want to use. I added the **message payload** to the row. Click `Continue` when you’re ready.

<Frame>
  <img src="https://mintcdn.com/watermelon/2oQVNKq2_kJvRRgW/images/integrations/zapier/create-row-sheets-zapier.png?fit=max&auto=format&n=2oQVNKq2_kJvRRgW&q=85&s=f7c2799e9570b976a8867f5106b454a9" alt="Create Row Sheets Zapier Pn" width="3098" height="1712" data-path="images/integrations/zapier/create-row-sheets-zapier.png" />
</Frame>

<Note>
  Zapier’s free plan is limited to two-step Zaps. If you want to add multiple steps, you’ll have to upgrade to a paid plan.
</Note>

### **6. Test the action**

The final step is to see if your action works as expected. In the `Test` section, click `Test step` to run the action step.

The next screen will show you whether or not Zapier has been able to successfully perform the action step for you.

<Frame>
  <img src="https://mintcdn.com/watermelon/V0Btc937jLqMJttP/images/integrations/zapier/publish-zap.png?fit=max&auto=format&n=V0Btc937jLqMJttP&q=85&s=649c5f714ac49aa67c4e492185687316" alt="Publish Zap Pn" width="3094" height="1714" data-path="images/integrations/zapier/publish-zap.png" />
</Frame>

Once you’ve set up your Zap action, you can add another action or finish setting up the Zap by clicking `Publish`. New conversations will now get synced with your chosen action app.

## Watermelon actions

A Zap consists of a trigger and an action. The trigger starts the workflow; in Watermelon, you can use the following actions:

| Action                      | **Description**             |                                                                                                                         |
| --------------------------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| New contact                 | Creates a new contact       | You can set the default and custom fields with custom values                                                            |
| Send a message              | Send a message              | You need the conversation ID, if this is not provided a new conversation will be created. You can map the message body. |
| Updates an existing contact | Updates an existing contact | You need a contact ID.                                                                                                  |

| Search action     | Description               |
| ----------------- | ------------------------- |
| Find a contact    | Find a contact by id      |
| Find conversation | Find a conversation by id |
| Search contacts   | Search a contact by value |
