> ## Documentation Index
> Fetch the complete documentation index at: https://developers.explorium.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Integrate with Zapier
> This document provides an overview and guidance on how to use our company's Zapier integration.
## Introduction
Zapier is a powerful automation tool that allows you to connect our service with hundreds of other apps. With Zapier, you can create automated workflows called "Zaps" that transfer data between different applications, saving you time and reducing manual effort.
## Getting Started
Navigate to Zapier and either log in to your existing account or create a new one.
Search for our app in the Zapier app directory and connect your account using the provided credentials, click on the account field:
Click on "connect a new account" and a window to enter the credentials will open:
Explorium api key is required, open ai key is optional, but is necessary to use the MCP action, all the other action require only Explorium's key.
Begin creating your Zaps by selecting a trigger from our app and an action from another app (or vice versa).
To use Explorium's API click on the zap box
Then search for explorium:
After that you can choose which action do you want to use (enrich, match, fetch):
### Triggers
Triggers are events within our application that can initiate a Zap. The following triggers are currently supported:
* **New Item Created:** Triggers when a new item is added to your account.
* **Item Updated:** Triggers when an existing item is modified.
### Actions
Actions are tasks that Zapier performs in another application when a trigger occurs. The following actions are available:
* **Fetch:**
We have 2 Fetch actions - businesses and prospects, in each fetch business you can fill the different fields, some are dropdowns, some are free values with a certain pattern listed, the first few fields which have limited values, are dropdowns with fixed values (eg. company size, age, revenue, etc), other fields are free text but with a format stated when hovering on the name (NAICS, category fields, etc.)
* **Output:**
The output on fetch actions is with line items, meaning each field getting back from the fetch api has all the values returned in an array, so for example, if you got 10 results, each field will have all the 10 results by the order it got them.
* **Match:**
There are 2 Match actions, for businesses and prospects
* **Output:**
The output for the match actions will be one field which is the matched id
* **Enrich:**
Each of the enrich actions can get either a matched id, or the same inputs as matching, if given the same inputs as matching (For example email in prospecting or company name and website in businesses) it will match before enriching, if given a matched id it will skip matching and enrich, all the fields are optional but it is required to insert at least one of the above. Each enrich action has a dropdown to choose which enrichments you want to enrich.
After enriching, in the next step the output will be available, with each field separate and the user can choose which fields he wants to continue with
* **MCP:**
To use Explorium’s MCP we are using an Endpoint that you can write to the mcp, and get a response
* **Output:**
The output for the mcp prompt will be one field - Response, you can use the response as it is, or use one of zapiers actions to extract data or filter data out of it, here is an example output and how to use it in zapier:
The response is analyzed by zapier’s AI action, and being returned to the google sheet after it extracted the relevant fields we wanted from the MCP response.
## Templates
Templates are ready sets of actions that can be copied and used by one click.
Each template can be used to create a zap, after using a template the user can change any action or any of the fields. **Example of a templates:**
In this case, after the user will choose this template, he can alter the fields to his use, or to his purpose, the webhook can be changed to any trigger (Google sheets, slack, email, etc).
In the Explorium MCP action, the prompt and the fields being sent can be changed
This is the prompt text in the template, it is editable and can be changed, the output format will stay the same regardless (in the MCP action, the output is always a “response” field for example).
Another template that can be used is the company research:
Here, after the user will choose to use this template, he can change the inputs to be to his desire, and also edit and change the MCP prompt as before, in this template we utilize “AI by Zapier” to extract different columns to be sent back to the google sheet.
The configurable fields are fully customizable, the template is just a general direction of a specific flow that can be changed to the user needs.
## Using Webhooks
### Introduction to Webhooks
Webhooks: Webhooks are automated messages sent from an application when a specific event occurs. They are used for real-time data communication between different systems, allowing one application to notify another about an event as it happens, rather than relying on periodic polling.
### Prerequisites
Before starting, ensure the following are in place:
* Active Zapier account.
* Access to our API documentation and necessary API keys/tokens. [https://admin.explorium.ai/](https://admin.explorium.ai/)
* Understanding of the specific API endpoints and data structures relevant to the integration.
### Creating a Webhook Zap in Zapier
#### Setting up the Trigger (Webhook)
Navigate to your Zapier dashboard and click "Create Zap."
Search for and select "Webhooks by Zapier" as the trigger app.
Select "Catch Hook."
* Copy Webhook URL: Copy the provided Zapier Webhook URL. This URL will be used to send data from our APIs.
* The url to connect the webhook is present in the "Test" tab:
### Configuring Our API to Send Data to the Webhook
The webhook api docs: [/reference/webhooks](/reference/webhooks)
Follow the guide at Explorium documentation for webhooks.
Take the url from the webhook action in zapier, and use it in "webhook\_url", the partner id can be visible in the admin app topbar.
After setting up the webhook, enroll into the events you would wish to accept, this can be done with this api: [/reference/businesses/events/add\_businesses\_enrollments](/reference/businesses/events/add_businesses_enrollments) Here is an example call for that endpoint:
### Setting up the Action (Integrating with Other Apps)
Select the desired application (e.g., Google Sheets, Slack, CRM) and the specific action event (e.g., Create Spreadsheet Row, Send Channel Message, Create Contact).
Connect your account for the chosen action app.
Map the data received from the Webhook (from "Catch Hook") to the fields required by the action app.
After setting up you’re webhook, you can use different actions zapier has, one recommended action is the Explorium mcp - Connecting the webhook to Explorium’s MCP allows you to research the event, and send the response to any application.
