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

# Zapier

> Start Zaps when conversations arrive or change, and work your inbox from 7,000 apps.

Send new conversations to a spreadsheet, post them in a team chat, add
customers to your CRM, or reply from another tool. The miniDesk app on Zapier
uses the same [webhooks](https://docs.minidesk.ai/guides/webhooks.md) and [API](https://docs.minidesk.ai/api-reference/introduction.md)
as any integration.

## Connect

1. In miniDesk, go to **Settings → API** and create an API key just for Zapier,
   so you can revoke it on its own.
2. In Zapier, pick **miniDesk** as the app of a trigger or action, choose
   **Sign in**, and paste the key.

Zapier checks the key by listing the webhooks it made. It reads no
conversation to do that.

## Triggers

| Trigger | Fires when |
| - | - |
| **New Conversation** | A customer starts a conversation. Its first message comes with it. |
| **New Customer Message** | A customer writes again in a conversation that already exists. |
| **Conversation Status Changed** | A conversation moves to another status, for example resolved. |
| **Conversation Assigned** | A conversation gets a new assignee, or loses its assignee. |

They are instant. Turning a Zap on adds a webhook to your workspace, and
turning it off removes it. You see these webhooks under **Settings → Webhooks**,
marked as made by your Zapier key. Revoking the key removes them too.

While you build the Zap, Zapier shows your three most recent conversations as
samples, in the same shape a live Zap gets. A workspace with no conversation
yet gets one example instead.

Each trigger gives you `conversation` (status, priority, category, channel,
language, and the customer's name and email), `message` on the first two,
`change` on the last two, and `actor`: who caused it. Internal notes, AI
drafts and your team's email addresses are never sent.

> [!NOTE]
>
> Conversations your team starts, and ones this same key creates, do not fire
> **New Conversation**. A Zap that creates a conversation never sets itself off.

## Actions

* **Send Reply**: send a reply to the customer. This reaches a real person and
  cannot be unsent.
* **Add Internal Note**: add a note to a conversation that only your team sees.
* **Create Conversation**: save a message a customer sent you elsewhere as a
  new conversation. The AI may answer it, as it would on any channel.
* **Create or Update Customer**: create a customer, or change the name and
  note of the one with this email.

## Searches

* **Find Customer**: find a customer by email.

## Example: new conversations to a sheet

1. Trigger: **miniDesk → New Conversation**.
2. Action: **Google Sheets → Create Spreadsheet Row**, with `Conversation
   Reference`, `Conversation Requester Email` and `Message Body`.

A Zap can post a conversation into a team chat, but a reply typed there does
not reach the customer. To answer from Slack, use miniDesk's own Slack
integration on the **Channels** screen.


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