# Guide: Using Zapier with Databox

Zapier is a tool that allows non-technical users to connect Data Sources that Databox doesn't natively integrate with.

A connection between two apps is called a Zap. A Zap is made up of a trigger and action(s). Whenever the trigger happens in one app, Zapier will automatically perform the action(s) in another app.

When we set up Zaps to sync data with Databox, Databox is set as the app where the action is performed.

## How to create a new Zapier token

![](/assets/guide-using-zapier-with-databox_1.620b95d261a65069038632199fd9aa3cd48345be4dd478667fc9f585cf52f021.4783b0ec.gif)

To create a new Zapier token, go to **Data Manager > + New connection**. Type **Zapier** in the search bar and click on the green **Create Token** button, then select  **Create Token**in the popup window.

Enter a name for your new token and click the **Create** button. This will create a unique push token that will allow Zapier to send data to your Databox Account.

## How to access pre-built Zaps

When you create a new token, you will have the ability to choose from **pre-built Zaps**. This can simplify the process of using Zapier to sync your data.

![](/assets/guide-using-zapier-with-databox_2.822a9c2a9e9214ccb418fe74fb2faddd72b965005f2db473ed69c507d79a3284.4783b0ec.gif)

After the initial connection process, you can access pre-built Zaps directly from the **Home** page in **Zapier** by using the search field. Enter "**Databox"** in the search field or click [here](https://zapier.com/apps/databox/integrations) to access **Popular** Zaps drop-down to view **pre-built Zaps**.

![](/assets/guide-using-zapier-with-databox_3.7655779d493c8ae60a349fd8c0953dfcf7b18dd32c4d052e7fe087ca0f3642a4.4783b0ec.gif)
Learn more about the Zapier + Databox integration and the data you can sync [here](https://zapier.com/apps/databox/integrations).

## How to create new Zaps in Zapier

Let's say we want to use Zapier's built-in Email service for email tracking. To do this, we'll create a Zap that's triggered every time we forward an email to a custom "@zapiermail.com" address.

We will forward emails from Client 1 to this address to get a better understanding of how often we receive messages from them.

1. Navigate to your **Home** page in Zapier. Click the orange **+ Create Zap** button


- In order to give your Zap a name click on "Untitled Zap" in the upper leftand enter a new name for your Zap.
![](/assets/guide-using-zapier-with-databox_4.f898b8199dacfb96bec87dc4b7fb5a1824f430f19418077760b345ae81aba0a9.4783b0ec.png)


2.**CHOOSE APP & EVENT:** Since we're using a built-in Zapier app, we'll select **Email by Zapier** from the **App event**list

![](/assets/guide-using-zapier-with-databox_5.f7ac571c42058785a233b65f6064dd7d34c919937047e75ff49d511a986bebb0.4783b0ec.gif)

1. We want this Zap to be triggered when an email is forwarded to our **zapiermail.com** email address. So, we'll select **New Inbound Email** for the **Event**(selection is automatically saved).


![](/assets/guide-using-zapier-with-databox_6.265c4bcbfed849a92d9edb4640b476baaead5791df5e6247cc1a91832e2888aa.4783b0ec.png)

Click the blue **Continue** button.

1. **SET UP TRIGGER:**Next, we need to customize our @zapiermail.com email address. Enter a string in the text field and click **Copy to Clipboard** to copy the custom @zapiermail email address. This is the email address where we will forward messages from Client 1.


Click the blue **Continue**button.

![](/assets/guide-using-zapier-with-databox_7.a8be21710fd29fcf488c6810c950f2ef3414cff577aca7abe7de1370090b942e.4783b0ec.gif)

1. **TEST TRIGGER:** At this point, it's best practice to **Test trigger** and our current setup
2. **CHOOSE APP & EVENT:** Next, we'll need to define an Action that follows the trigger. To start, we'll choose **Databox** as the **Action App**from the **App event** list.


![](/assets/guide-using-zapier-with-databox_8.d5e07fe2276cdc8720d0dbad520055cf5aa7e1c870d443002c019fb2d0e7a09e.4783b0ec.gif)

1. Now we must select a **Databox Event**(action). Databox Event define how the data is tracked.


- Increase Counter: Every Action that is triggered in a Zap will count as 1 event. This means that Databox will increment the current value by 1 each time the Zap is triggered.
- Push Custom Data: Every Action that is triggered in a zap will sync as custom data with Databox.


For our example, we'll select **Increase Counter,**so we can easily see the total number of emails we're receiving from Client 1.

![](/assets/guide-using-zapier-with-databox_9.b9265bc1dd6152158b18d60c03e77283998b0f0c0389e32d1b6b9270a6598d68.4783b0ec.png)

Click the blue  **Continue**button.

8.**CHOOSE ACCOUNT:**Here we must select a **Databox** Account. If you don't have Databox connected, click +  **Connect a new account**. This will open a window where you can enter the push token that was generated for Zapier

![](/assets/guide-using-zapier-with-databox_10.ddfcb9153ea1d65f146143978e648c794bdc9eeac4f447b664b51031a933633a.4783b0ec.png)

1. **SET UP ACTION:** Rather than increasing the counter for a Metric that already exists in our Databox Account, we want to create a completely new Zapier Metric that's tracking this data.


To do that, we'll select **Custom**from the **Metric** drop-down list. Now we will be able to enter the name for our Metric to the **Metric** field. This is the Metric name that we'll select in the Designer in Databox.

For our example, we'll enter **Emails Received From Client 1** as the **Metric**.

![](/assets/guide-using-zapier-with-databox_11.6ccec61eccf7b330e50f7fc72916806453cc26ce3fa8f6cabc22f2520fe60a0c.4783b0ec.gif)

10.**TEST ACTION:**We can now send a test counter to Databox to confirm everything is working as expected

1. Click **Publish Zap** to complete and activate the Zap


## How to build a Databoard using Zapier data

![](/assets/guide-using-zapier-with-databox_12.03a15d27e7756dad62e7ba662e21c155c168eb8163bb399ba81f315cf0a8c44b.4783b0ec.gif)

1. Navigate to **Databoards** > **+ Create New Databoard** > **Start Blank**
2. Click on the **Visualization Types** icon under the Metric Library icon on the left-hand side of the Designer.
3. View the list of Visualizations available in Databox. Drag and drop your selected Visualization onto your Databoard.
4. Click on the Datablock on the Databoard to open the corresponding **Datablock Editor**on the right-hand side of the Designer.
5. In the **Metrics** drop-down, click **Data Source** to select the appropriate Zapier Data Source. This will filter out metrics from the specific Data Source.
6. Select the metric you'd like to display on the Datablock, using the Search bar if needed. This will update the Datablock, and it will populate with the corresponding data.