> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.nector.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Nector and Freshmarketer Integration

In this article we will show you how to set up the Freshmarketer Integration on your **Nector** dashboard.

### Setting up the Integration

Visit the [Integrations](https://merchant.nector.io/integration-list) Page. Click on  **Email & WhatsApp Marketing** in the side-bar. Scroll below to look for **Freshmarketer** in that section.


![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_1sqsouc.png)

Click on **Configure** to open up the Freshmarketer integration page.


![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_lsxggw.png)

First to enable the integration, you need to get the bundle alias and API key from your Freshmarketer dashboard.

##### Getting your bundle alias and API key

*   Login to your Freshmarketer dashboard.
*   From the left side menu, click on **Account Settings** link. See below image for reference.


![](https://storage.crisp.chat/users/helpdesk/website/b998efc0b6694000/27466fbd-b558-4aa4-ab14-a26f59_1bws470.png)

*   Then search for **API** here, and then click on **API Settings** link as shown below.
    

![](https://storage.crisp.chat/users/helpdesk/website/e81b171671f88000/2de87196-d307-410e-a1d7-c6defd_oqylas.png)

*   Next, complete the **I am not a robot** verification. And you will be able to see your API details.
*   Copy the API key and the bundle alias.
 

![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_jtg6wp.png)


Now paste it in your **Nector** dashboard. Under **Choose Common property**, select **Email** as the mode of communication

|| **Choose Common Property** - This refers to the user property of Nector which will be used when sending the event. 

Finally, click on **Initialize** button to button to enable the integration. Once it is enabled, you will see the below view.


![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_u8iz68.png)

#### Sending Events To Freshmarketer

Events can be sent to Freshmarketer when certain things happen on Nector. You can then setup automations on Freshmarketer, which can be triggered when the event occurs on Nector. For example, when a customer is rewarded with wallet coins, an event can be sent to Freshmarketer, which in turn will trigger an automation that sends an email to the customer.

##### Add new event

Switch to the **Events** tab and click on **Create An Event**. It opens up to the **Events** page with the **Send Events** tab. Now you have to select the event on which you want to notify the external integration.

There are many events supported on **Nector**. If you don't know which to choose, here are the two events that are most relevant and commonly used:

* **Wallet Coins Rewarded:** This event will be sent whenever wallet coins are rewarded on nector.
* **Coupon Is Created**: This event will be sent whenever a customer uses his wallet coins to get a discount/coupon code on nector.

For example, 
To send an **Wallet Reward Event** to **Freshmarketer** whenever wallet coins are rewarded to a customer on nector, you would create the event as shown below.

* Click on **"+"** button to create an event.
* For **"Event"** option, select **Wallet Coins Rewarded** 
* For **"Send event to"** option, by default **Freshmarketer** will be selected.


![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_iv3n5y.png)

* Once you have entered all the details, click on the **Create** button in the popup. The event will be created as below.


![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_1vxr7pv.png)

##### Sending Test Event

|| In order to make this event available in your Freshmarketer dashboard, you need to send a test event from **Nector** as shown below. After this, you can setup the flow on Freshmarketer using this event as the trigger.

Click on the **Event** you just created

You can send a test event by clicking on **Send Test Event**.

A popup opens, enter the email id where you want to send the test email.


![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_1hwnocv.png)

|| Kindly note, **the Email id of customer to whom email has to be sent** needs to exist in the Customers database of your store.


### Setting up Automations on Freshmarketer

After you are done setting up events to be sent to Freshmarketer from Nector, you can create automations on Freshmarketer in response to the Events. For this, read the steps below:

1. Go to your Freshmarketer dashboard. Look for **Journeys** and click on it.


![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_u28dnw.png)

2. Click on **Create Journey**  and then **Create from scratch** to create a new Journey. Enter the desired name of the journey and click **Save and next**

|| Also, make sure to tick the "Allow the same visitor or customer to enter this journey multiple times" option.

![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_p7f2k7.png)


![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_k2u3lf.png)

3. Drag and Drop "On Shopify Event".


![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_lgjx4f.png)

4. In this example since we have created an event for wallet reward, we will be choosing the "walletreward_create" trigger from the options of "Select custom event". Save it.

|| Inorder to make the trigger available in your Freshmarketer dashboard, a sample event needs to be sent from nector. This sample event can be sent to Freshmarketer simply by adding some coins to an account on Nector. To reward coins manually refer to this article [Manually reward coins to customers](https://help.nector.io/en/article/how-to-manually-reward-coins-to-customers-1krws56/?bust=1712832149710)

| If you would like to create Flows for a separate event, kindly contact the Nector team, by referring [here](https://help.nector.io/en/article/support-channels-lnyfsh/?bust=1712816129024)


5. Drag and Drop "Send Email" and connect it to the previous trigger.


![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_11we67q.png)

6. Click on "Choose your email" and then click on "Create Journey Email". In the new page you can select from a list of predefined templates or you can also write your own email from scratch. 


![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_124olgt.png)

7. After customizing your email and filling the necessary details, click on **Publish**. 


![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_1k1xubu.png)

8. Drag and Drop "Exit Journey" and connect it the previous flow "On Sent".


![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_1b5oszf.png)

9. Finally click on **Start Journey** and it will be live.


![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_1wiqcox.png)

---

|| Events can also be sent for other things like when a new customer is referred, for coin expiry notification, for review request, and more. To learn how to setup these events, look into those respective articles.

| For a list of events and the data associated with each event, please refer this article for more info: [https://nector.crisp.help/en/article/event-details-sent-to-external-integrations](https://nector.crisp.help/en/article/event-details-sent-to-external-integrations-frcz1t/)

### Related Articles

* [Events](https://help.nector.io/en/article/events-1wetiqa/?bust=1715669959393)

* [Event details sent to External Integrations](https://help.nector.io/en/article/event-details-sent-to-external-integrations-frcz1t/?bust=1715669995873)
