MailInApp
Documentation menu

Zapier

Connect MailInApp to the thousands of apps on Zapier: put new leads in a spreadsheet, post booked meetings to Slack, open a CRM record when a deal is won, or add a contact to MailInApp when something happens elsewhere.

The MailInApp Zapier app

MailInApp is in Zapier's app directory: zapier.com/apps/mailinapp/integrations. It's currently listed as a beta app. You connect it with an API key and pick triggers and actions from menus, with no URLs to copy:

  • Triggers: one for each account event, including New Lead, Lead Turned Hot, Meeting Booked, Deal Stage Changed, Form Submitted, Purchase Completed, Journey Completed and Response Completed.
  • Actions: Create or Update Contact, Trigger Journey, Create Deal, Update or Move Deal, and Send Transactional Email.
  • Search: Find Contact, which pairs with create as "Find or Create Contact".

Connect MailInApp to Zapier

  1. In MailInApp, go to Developers and click Create key. Name it after the integration, such as "Zapier". Copy the key, which starts with mia_live_. It's shown only once. If Create key is locked, your plan doesn't include API keys yet. See API keys for how keys work.
  2. In Zapier, create a Zap and choose MailInApp as the trigger or action app.
  3. When Zapier asks you to connect an account, paste the key into the API Key field.
  4. Choose a trigger or action. Menus such as lists, journeys, deals and pipelines fill in from your account.
  5. Use Test trigger or Test action, then turn the Zap on.

The key acts as your whole MailInApp account, so treat it like a password. Revoking it under Developers disconnects Zapier and stops the triggers it set up.

Without the MailInApp app (advanced)

You don't need the app to use Zapier with MailInApp. The built-in Webhooks by Zapier app works with the same events. It's the right choice when you want one email's interactions only, such as each answer to a single survey, or when you'd rather manage the URLs yourself.

Send MailInApp events to a Zap

  1. In Zapier, create a Zap with Webhooks by Zapier as the trigger and Catch Hook as the event. Copy the URL Zapier gives you.
  2. In MailInApp, go to Developers → Webhooks. Paste the URL as the Endpoint URL, tick the events this Zap should get, and click Add webhook. Keep the signing secret if you plan to check signatures later.
  3. Click Send test on the new webhook, then Test trigger in Zapier. You'll see the sample event, with its type and every field inside data, such as the contact's email or the deal's stage.
  4. Add your action steps, mapping the fields you need, and turn the Zap on.

Every event has the same shape: an id, a type, a createdAt time and a data object. The webhooks page lists each event and its fields. If one Catch Hook gets several event types, add a Filter by Zapier step on type, or create one webhook per Zap.

Only want one email's interactions? Paste the Catch Hook URL into that email's project webhook on its Responses page instead.

Act on MailInApp from a Zap

Use a Webhooks by Zapier → Custom Request action to call the MailInApp API with your API key in an Authorization: Bearer mia_live_… header. For example:

  • Add or update a contact when a form is filled in elsewhere: POST /api/v1/contacts.
  • Open a deal when a lead books a call in another tool: POST /api/v1/deals. Set an Idempotency-Key header, such as the other tool's record id, so a Zap retry doesn't create a second deal.
  • Enroll a contact in a journey whose trigger is API call: POST /api/v1/journeys/{id}/trigger.
  • Send a receipt or notification: POST /api/v1/send with "type": "transactional". Don't send marketing email from a Zap: a Zap can't show that the recipient agreed to it.

When a delivery fails

A paused or deleted Zap, or a Zapier outage, counts as a failed delivery. MailInApp retries it automatically for several hours. The event itself is always stored in MailInApp first, so nothing is lost on the MailInApp side.

Getting help

  • A Zap isn't working, such as a step that errors or a trigger that doesn't fire in Zapier: get help from Zapier at zapier.com/app/get-help. Zapier sees the Zap's task history, which we can't.
  • Something is wrong in MailInApp itself, such as a key that won't create, a webhook that shows failed deliveries or an event that never arrives: contact MailInApp support.