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

# Zapier

> Connect Adraa Inbox to thousands of apps — trigger Zaps on new messages and run inbox actions from anywhere.

The Adraa Inbox Zapier integration lets you connect your inbox to thousands of
other apps without writing code. Start a Zap when a message arrives, and run
inbox actions — send a reply, tag a contact, close a conversation — from any app
Zapier supports.

## Connect your account

1. In Adraa Inbox, an admin opens **Settings → API** and creates an API token
   (it looks like `adraa_…`). Copy it — it's shown only once.
2. In Zapier, add an **Adraa Inbox** step and choose **Connect a new account**.
3. Paste the API token. Zapier verifies it and labels the connection with your
   workspace name.

The token is workspace-wide. Revoke it any time from **Settings → API** to
disconnect every Zap using it.

## Triggers

Triggers start a Zap. They poll the inbox on Zapier's schedule (every 1–15
minutes depending on your Zapier plan).

| Trigger              | Fires when                                                                                   |
| -------------------- | -------------------------------------------------------------------------------------------- |
| **New Message**      | A message arrives. Inbound (from the contact) by default; you can switch to outbound or all. |
| **New Conversation** | A new conversation is created. Optionally filter by channel or status.                       |
| **New Contact**      | A contact first appears in the workspace (their first conversation).                         |

## Actions

Actions run as steps in a Zap.

| Action                            | What it does                                                                                   |
| --------------------------------- | ---------------------------------------------------------------------------------------------- |
| **Send Message**                  | Reply to a contact in an existing conversation.                                                |
| **Assign Conversation**           | Assign a conversation to an agent (or the workspace AI).                                       |
| **Close / Reopen Conversation**   | Change a conversation's status.                                                                |
| **Create Contact & Conversation** | Create a contact by email and open an email/web conversation, optionally with a first message. |
| **Update Contact**                | Update a contact's name and custom fields.                                                     |
| **Set Contact Tags**              | Replace the tags on a contact.                                                                 |
| **Send WhatsApp Broadcast**       | Send an approved template to a saved contact group.                                            |

## Searches

| Search                | Finds                                              |
| --------------------- | -------------------------------------------------- |
| **Find Contact**      | A contact by name, email, or phone.                |
| **Find Conversation** | A conversation by search text, contact, or status. |

## Example Zaps

* **New Message → Slack:** post every inbound WhatsApp message to a Slack channel.
* **New Contact → Google Sheets:** append a row for every new contact.
* **Typeform → Create Contact & Conversation:** open a conversation when someone
  submits a form.
* **Shopify order → Send WhatsApp Broadcast:** notify a group about an update.

<Note>
  Triggers poll on Zapier's schedule, so there's a short delay (your poll
  interval) between an event and the Zap running. Everything is scoped to the
  workspace the API token belongs to.
</Note>

All actions map to the [public REST API](/api-reference/introduction); you can
build the same automations directly against `/api/v1` if you prefer.