# What is Murlist.com?

Send hyper-personalized video cold emails at scale.

**Murlist.com** is a cold email outreach solution built to help you win more deals effortlessly using hyper-personalized videos.\
\
We are built to help sales teams and professionals improve the open rate, reply rate. Currently, we boost of **1:1** **open to CTR** rate for cold emails.

### What you can do with Murlist.

1. Send video cold emails
2. Warm up your mailbox
3. Clean up your list
4. Get new prospects

####


# How it works

How the drip campaign works

The email drip campaign allows anyone to create an email sequence that can run over weeks and include video emails, text emails, images emails, delays, and follow-ups.

The most important thing to understand is that each action is considered a step in the drip campaign. And to create a drip campaign, you have a few drip steps available to create an email sequence:

### Email (text):

This step allows you to compose unique text emails. Using special tags like and, you can dynamically create a unique email body and subject for each prospect.

![compose a text email](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MffofKU4qlBJ-MM3i-D%2F-MffpnZQw6LNKgZ6ZUlw%2Fcompose%20email.png?alt=media\&token=17100c31-af83-4b4f-817b-eaa637c359d0)

### Delay step:

A wait-time, in hours, between the execution of the previous step and the next step.

![delay step](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MffqKgjOSJGU3-TvCZs%2F-MffrG7hr1pgHRSFQGKy%2Fdelay%20email.png?alt=media\&token=ad7a2a89-7d6c-49fa-868d-78f1cae7e429)

In the above example, there will be a delay of 24 hours after the first step is completed and the last email.

### Email (image):

It works in the same way as the email text step but provides you the option to place hyper-personalized image content in an email. This image could be a unique gif of the prospects' site (you only have to provide the site URL). It could also be a mockup of the user's logo. This requires you to create a base template using the design studio and provide the assets you want dynamically replaced.

### Email (video)&#x20;

The video emails work the same as the image and text emails with one unique difference. The content can be video personalized for each prospect. All you have to do is upload a list and a selfie-like video. Ideally wave, or appear to greet on this video. Using this video, Murlist creates unique video content for each user.

The image and video emails are still in closed access beta. You can request access here: <support@murlist.com>


# How to create a drip campaign

A complete guide to create an email drip campaign

Here is a demo video on creating a campaign:

{% embed url="<https://youtu.be/O9lhByeLHoc>" %}


# Add an email account

Here how to add a sender email account on Murlist.com and also configure it for email warming.

{% embed url="<https://youtu.be/tOuIJA67hKg>" %}


# Custom domain


# How to setup domain or subdomain for email tracking

Use your own domain in tracking email activities.

Domain tracking is unique for each sender account. We recommend using the same domain as the account.&#x20;

For instance, if the email is <paschal@murlist.com>, the tracking domain could be any subdomain of murlist.com example; smart.murlist.com

## How to setup domain or subdomain for email tracking

#### 1. [Go to MurList - Automated Personalized Video Cold Emailing](https://murlist.com/campaign)

![Go to MurList - Automated Personalized Video Cold Emailing](https://images.tango.us/public/screenshot_93396578-2505-46fd-9618-df0c0c225e68?crop=focalpoint\&fit=crop\&w=undefined\&ar=1367%3A683)

#### 2. Click on the profile icon

![Click on image](https://images.tango.us/public/screenshot_16906d95-ae0d-4ce0-81f9-fbbf23d328ce?crop=focalpoint\&fit=crop\&fp-x=0.9283101682516459\&fp-y=0.04685212298682284\&fp-z=2.8830730265934994\&w=undefined\&ar=1367%3A683)

#### 3. Click on Settings

![Click on Settings](https://images.tango.us/public/screenshot_525059db-4400-458f-a511-0fa890f1b8f1?crop=focalpoint\&fit=crop\&fp-x=0.8690563277249451\&fp-y=0.16691068814055637\&fp-z=2.835201328352013\&w=undefined\&ar=1367%3A683)

#### 4. Click on Email account

![Click on Email account](https://images.tango.us/public/screenshot_27ea8a86-758d-4e99-8da9-fb9f19faf169?crop=focalpoint\&fit=crop\&fp-x=0.1276517922457937\&fp-y=0.32210834553440704\&fp-z=2.749949708308187\&w=undefined\&ar=1367%3A683)

#### 5. Click on highlight

![Click on configure mailbox icon](https://images.tango.us/public/screenshot_7dc28c73-fc3f-46b0-8a65-d5c7b469e4ce?crop=focalpoint\&fit=crop\&fp-x=0.8789319678127286\&fp-y=0.6625183016105417\&fp-z=2.9969284774023692\&w=undefined\&ar=1367%3A683)

#### 6. Click on edit →

![Click on edit →](https://images.tango.us/public/screenshot_1598cb03-64ab-4848-a405-2bd1f291e24c?crop=focalpoint\&fit=crop\&fp-x=0.9462326261887345\&fp-y=0.6054172767203514\&fp-z=3.0779630464173056\&w=undefined\&ar=1367%3A683)

#### 7. Type the subdomain or domain you want to use.

![configure subdomain ](https://images.tango.us/public/screenshot_150d2e64-0c04-43d4-931a-ee5ea7ee0d78?crop=focalpoint\&fit=crop\&fp-x=0.7483540599853694\&fp-y=0.232796486090776\&fp-z=2.106317411402157\&w=undefined\&ar=1367%3A683)

#### 8. Verify custom domain:

* Configure your domain or subdomain to point to murtrack.com (as a CNAME)
* Click on verify domain


# How to setup domain or subdomain for video landing page

The landing page domain allows you to host the videos your users are sent on your own domain.&#x20;

Each sender account has its own landing page domain configuration option. If you can, use a subdomain of the sender account for the landing page domain setup. This greatly improves deliverability as everything is coming from the same domain.

## How to setup domain or subdomain for landing page

#### 1. [Go to MurList - Automated Personalized Video Cold Emailing](https://murlist.com/campaign)

![Go to MurList - Automated Personalized Video Cold Emailing](https://images.tango.us/public/screenshot_93396578-2505-46fd-9618-df0c0c225e68?crop=focalpoint\&fit=crop\&w=undefined\&ar=1367%3A683)

#### 2. Click on the profile icon

![Click on image](https://images.tango.us/public/screenshot_16906d95-ae0d-4ce0-81f9-fbbf23d328ce?crop=focalpoint\&fit=crop\&fp-x=0.9283101682516459\&fp-y=0.04685212298682284\&fp-z=2.8830730265934994\&w=undefined\&ar=1367%3A683)

#### 3. Click on Settings

![Click on Settings](https://images.tango.us/public/screenshot_525059db-4400-458f-a511-0fa890f1b8f1?crop=focalpoint\&fit=crop\&fp-x=0.8690563277249451\&fp-y=0.16691068814055637\&fp-z=2.835201328352013\&w=undefined\&ar=1367%3A683)

#### 4. Click on Email account

![Click on Email account](https://images.tango.us/public/screenshot_27ea8a86-758d-4e99-8da9-fb9f19faf169?crop=focalpoint\&fit=crop\&fp-x=0.1276517922457937\&fp-y=0.32210834553440704\&fp-z=2.749949708308187\&w=undefined\&ar=1367%3A683)

#### 5. Click on highlight

![Click on configure mailbox icon](https://images.tango.us/public/screenshot_7dc28c73-fc3f-46b0-8a65-d5c7b469e4ce?crop=focalpoint\&fit=crop\&fp-x=0.8789319678127286\&fp-y=0.6625183016105417\&fp-z=2.9969284774023692\&w=undefined\&ar=1367%3A683)

#### 6. On the landing page option, click on edit →

![Click on edit →](https://images.tango.us/public/screenshot_1598cb03-64ab-4848-a405-2bd1f291e24c?crop=focalpoint\&fit=crop\&fp-x=0.9462326261887345\&fp-y=0.6054172767203514\&fp-z=3.0779630464173056\&w=undefined\&ar=1367%3A683)

#### 7. Type the subdomain or domain you want to use.

![configure subdomain ](https://images.tango.us/public/screenshot_150d2e64-0c04-43d4-931a-ee5ea7ee0d78?crop=focalpoint\&fit=crop\&fp-x=0.7483540599853694\&fp-y=0.232796486090776\&fp-z=2.106317411402157\&w=undefined\&ar=1367%3A683)

#### 8. Verify custom domain:

* Configure your domain or subdomain to point to murtrack.com (as a CNAME)
* Click on verify domain


# Setup & configuration guide


# How to set up email warming

A quick guide on setting up email warming Warming on Murlist.com.

## How to add your Mailbox

To set up email warmup inbox, you have to follow the steps below.

#### Step One:

Login or create at <https://murlist.com/auth> and head to <https://murlist.com/dashboard>.

![Log into the Murlist dashboard and click add inbox to warm](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MaWXt2lXJmviQogNhhK%2F-MaWYJFRRT9-i3Oq6GGt%2FDashboard_murlist.jpg?alt=media\&token=a6516237-e0c4-4814-b007-cfcf10994690)

#### Step two:

Step two: Click on the "Add inbox to warm" button to add your mailbox. A form will open up. Fill the form with the appropriate details. \
The form has multiple sections:

* Sender details: This second is used in sending the warm up mails. This include your name and your email address.
* Warming behavior: Here you define how you would want warming to be executed.
* SMTP Setting: Here you define the SMTP configuration. [Here](https://murlist.com/blog/how-to-add-and-configure-google-suite-for-email-warming/) is a guide if you use GSuite.&#x20;
* IMAP Settings: You enter the IMAP settings for your mailbox here.<br>

![Configure sender details and email warmup inbox behavior ](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MaWbhxl-YymTVntOV31%2F-MaWcNCl_YlurEVgJi05%2FAdd%20Warming%20Mailbox%20Sender%20Details.jpg?alt=media\&token=de7837c0-bf61-456d-84fb-343bd0f6a98e)

![](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MaWd4ESMnT16v90zIlf%2F-MaWdaLDIoNTaueSzXA0%2FAdd%20Warming%20Mailbox%20SMTP_IMAP%20Details.jpg?alt=media\&token=c83be95e-a70b-4dbb-8a99-10ebb7e98a60)

Click on "**Add inbox**" to submit the form. The entry will be validated for a while and warming should start.

**Other steps to help you get started with email warmup inbox.**

* [x] How to add your mailbox for warming.
* [ ] [Configure AWS SES for warming.](https://help.murlist.com/email-warmup/configure-aws-ses-for-email-warmup-inbox-warming)
* [ ] [Configure MailGun.](https://help.murlist.com/email-warmup/configure-mailgun)
* [ ] [Configure Gsuite | Google workspace.](https://help.murlist.com/email-warmup/configure-gsuite-gmail-for-email-warming)
* [ ] [Configure Office 365.](https://help.murlist.com/email-warmup/configure-microsoft-office-365-mailbox-for-email-smtp-warming)
* [ ] [Configure Yahoo Mail](https://help.murlist.com/email-warmup/configure-yahoo-mail)
* [ ] [Warming Checklist.](https://help.murlist.com/email-warmup/a-few-considerations-before-warming-your-email-inbox)<br>


# Configure GSuite/Gmail

How to add and configure Google suite for email warming.

We have 2 integration options available for Google mailbox. The first option uses Google's one-click integration but does have a minor limitation. The second, which uses SMTP and IMAP, is fully featured and has no limitations.

## Option One: One-click integration.

One-click integration is now available. Please note that due to restrictions on the google APIs, a few features like tracking replies are not available. Use option 2 if you want better analytics.\
&#x20;\
To add your Google Workspace:

1. Go to <https://murlist.com/settings/email-accounts>
2. Click on the sign in with Google button as in the picture below

![](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MkFMKG0qdv1RS85LHW5%2F-MkFOQOm__C_erU5giY8%2FGoogle%20workspace.png?alt=media\&token=687a5cb8-5711-4139-b151-53e4e8226f8f)

That's all. You are all set!

## Option two: Add Your Mailbox's SMTP  & IMAP details: <a href="#add-your-mailboxs-smtp-imap-details" id="add-your-mailboxs-smtp-imap-details"></a>

\
Use this for full mailbox functionality. While this requires a few more steps to complete, it has better support for mail tracking & analytics.\
How to integrate:

* Go to <https://murlist.com/settings/email-accounts>
* Click on Add new SMTP/IMAP as in the picture below:

![](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MkFOmYCTX3KYKSmHw-1%2F-MkFPrzhZIrqtt88CSAC%2FGoogle%20IMAP%20and%20SMTP.png?alt=media\&token=7a2ed039-25cb-4e58-8f9e-3d0c069e4a27)

SMTP:\
Host: smtp.gmail.com\
Port: 587\
User: Your email address\
Password: Your email password

IMAP:\
Host: imap.gmail.com\
Port: 993\
User: Your email address\
Password: Your email password&#x20;

## Step One: Allow less secure apps <a href="#step-one-allow-less-secure-apps" id="step-one-allow-less-secure-apps"></a>

Head over to <https://admin.google.com/ac/security/lsa> and click on "*Allow users to manage their access to less secure apps".*

![](https://murlist.com/blog/content/images/2021/05/g_workspace_configure.png)

## Step Two: Allow user-level outbound gateway. <a href="#step-two-allow-user-level-outbound-gateway" id="step-two-allow-user-level-outbound-gateway"></a>

Go to <https://admin.google.com/ac/apps/gmail/enduseraccess?hl=en> and *"Allow users to send mail through an external SMTP server when configuring a from address hosted outside of your email domain."*

![](https://murlist.com/blog/content/images/2021/05/g_workspace_1.png)

Important: Save before exiting.

## Step 3: Allows Less Secure Apps (mailbox level) <a href="#step-3-allows-less-secure-apps-mailbox-level" id="step-3-allows-less-secure-apps-mailbox-level"></a>

Go to [https://myaccount.google.com/lesssecureapps](https://myaccount.google.com/lesssecureapps?pli=1) and toggle as in the picture below.

![](https://murlist.com/blog/content/images/2021/05/g_worspace_2.png)

## Step 4: Enable IMAP of the mailbox. <a href="#step-4-enable-imap-of-the-mailbox" id="step-4-enable-imap-of-the-mailbox"></a>

Log in to the specific mailbox and click on settings on the top right corner as in the picture.

![](https://murlist.com/blog/content/images/2021/05/g_workspace_3.png)

Then go to the Forwarding and POP/IMAP settings and Enable IMAP. The settings should look like this:

![](https://murlist.com/blog/content/images/2021/05/g_workspace_4.png)

## &#x20;<a href="#step-five-wait-for-an-hour-and-try-reconnect" id="step-five-wait-for-an-hour-and-try-reconnect"></a>

### Having issue?

1. Enable 2FA on your account.
2. Generate a unique password for Murlist.com **and use this as the password for the SMTP and IMAP.**

If you have [Two Factor Authentication (**2FA**)](https://en.wikipedia.org/wiki/Multi-factor_authentication) enabled for your account, then instead of the account password you need to generate a unique password for Murlist.&#x20;

### Here is a step-by-step guide on setup passwords for 2FA.

1. Go to your [Google Account](https://myaccount.google.com/).
2. Select **Security**.
3. Under "Signing in to Google," select **App Passwords**. You may need to sign in. If you don’t have this option, it might be because:
   1. 2-Step Verification is not set up for your account.
   2. 2-Step Verification is only set up for security keys.
   3. Your account is through work, school, or other organizations.
   4. You turned on Advanced Protection.
4. At the bottom, choose **Select app** and choose the app you using ![and then](https://lh3.googleusercontent.com/3_l97rr0GvhSP2XV5OoCkV2ZDTIisAOczrSdzNCBxhIKWrjXjHucxNwocghoUa39gw=w36-h36) **Select device** and choose the device you’re using ![and then](https://lh3.googleusercontent.com/3_l97rr0GvhSP2XV5OoCkV2ZDTIisAOczrSdzNCBxhIKWrjXjHucxNwocghoUa39gw=w36-h36) **Generate**.
5. Follow the instructions to enter the App Password. The App Password is the 16-character code in the yellow bar on your device.

## **Step Five: Wait for an hour and try to reconnect.** <a href="#step-five-wait-for-an-hour-and-try-reconnect" id="step-five-wait-for-an-hour-and-try-reconnect"></a>

Once you've completed steps 1-3, you will be able to connect your account! We suggest waiting for at least an hour so that the setting changes have time to propagate. Sometimes this could take up to 24 hours.\
If you experience any troubles, please reach out at <support@murlist.com>


# Configure Zoho IMAP & SMTP

Configuration guide for Zoho

To be able to use Zoho mailbox on Murlist, it has to be a paid account as Zoho restricts IMAP access on free accounts if you are using your company domain instead of @zoho.com.

## Add Your Mailbox's SMTP  & IMAP details: <a href="#add-your-mailboxs-smtp-imap-details" id="add-your-mailboxs-smtp-imap-details"></a>

For mailboxes using company's domain, use:

SMTP:\
Host:  **smtp.zoho.com**\
Port: 587 or 465\
User: Your email address\
Password: Your email password

IMAP:\
Host: **imappro.zoho.com**\
Port: 993\
User: Your email address\
Password: Your email pass

### Enable mailbox IMAP:

* Go to **Settings**
* Navigate to accounts [mail accounts](https://mail.zoho.com/zm/#settings/all/mailaccounts) and select the mailbox to update.
* Enable IMAP and save.
* Under the **IMAP** section, click **Launch folder settings.**

![enable IMAP for Zoho email](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-Mf71xH-8LXKe2HAGR98%2F-Mf7XTWbOefNlcp8XCz9%2Flaunchfolder.jpg?alt=media\&token=468d6117-c84c-4bb4-8d42-f13c98d11b45)

Select the folders to permit and save.

If you experience any troubles, please reach out at **<support@murlist.com>**


# Configure Microsoft Office 365

How to add and configure Microsoft 365 to MurList email warming.

To get MurList warm to work with Microsoft 365, there are a few things that you need to change from the admin center.

Here are the steps to complete the process:

### Configuration details:

**SMTP:** \
&#x20; Host: outlook.office365.com\
&#x20; Port: 587\
&#x20; Username: your email\
&#x20; Password: your password\
\
**IMAP**:\
&#x20; Host: outlook.office365.com\
&#x20; Port: 993\
&#x20; Username: your email\
&#x20; Password: your password

## Step One: <a href="#step-one" id="step-one"></a>

* Click on settings.
* Then click Admin Center.
* Then click show all within the admin center.
* Then click Azure Active Directory
* Then scroll down find the properties tab

## **Step 2: Adjust Admin Properties** <a href="#step-2-adjust-admin-properties" id="step-2-adjust-admin-properties"></a>

Within the admin properties section, you will need to Enable Security defaults to No.

To do this click "Manage Security Defaults" then click No within the right hand slider window. Toggle security default

![](https://murlist.com/blog/content/images/2021/05/admin-settings.png)

## **Step 3: Allow The Inbox To Use SMTP & IMAP** <a href="#step-3-allow-the-inbox-to-use-smtp-imap" id="step-3-allow-the-inbox-to-use-smtp-imap"></a>

A. First go back to the Admin Center and select Users > Active UsersSelect Active users

![](https://murlist.com/blog/content/images/2021/05/smtp_settings_A.png)

B. Select the inbox that you want to add to Warmup Inbox. By doing this a slider will come out like this:

C. Select the Mail tab within the slide and click Manage email apps

![](https://murlist.com/blog/content/images/2021/05/smtp_settings_B.png)

D. Ensure IMAP and Authenticated SMTP is checked.

![](https://murlist.com/blog/content/images/2021/05/smtp_settings_D.png)

## **Step 4: Wait for about an hour, then try reconnecting.** <a href="#step-4-wait-for-about-an-hour-then-try-reconnect" id="step-4-wait-for-about-an-hour-then-try-reconnect"></a>

Once you've completed steps 1-3, you will be able to connect your account! We suggest waiting for at least an hour so that the setting changes have time to propagate. Sometimes this could take up to 24 hours.\
If you experience any troubles, please reach out at <support@murlist.com>


# Configure AWS SES

Step-by-step guide on setting up and configuring AWS SES for warming.

There are two steps involved in the integration of AWS SES for sending emails.&#x20;

* Configure your domain correctly on AWS.
* Get SMTP details.
* Add your details to Murlist.com

### Configure your domain on AWS.

For most users, this step is usually completed already. Amazon has a help article on how to add your domain here: <https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-set-up.html>

![Add a domain on AWS SES](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MaWpPeffMiDgWeeGF5D%2F-MaXAb0K1ZRAcH9X5cOb%2FAdd%20AWS%20SES%20add%20domain.jpg?alt=media\&token=ece18c77-aa8f-46e5-ab93-1e732a63a7ee)

Next, ensure all DKIM and mail from are well configured. This is very important as it can make or break your campaign efforts.&#x20;

![Verify DKIM and Mail From domain are well configured](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MaWpPeffMiDgWeeGF5D%2F-MaXCER1AeWyfGfL_S-t%2FAdd%20AWS%20SES%20verify%20domain.jpg?alt=media\&token=03038b10-f1e9-47f8-9c12-8a0a656fa857)

### GET AWS SES SMTP details

Ensure you are in the same region and click on "SMTP setting". Copy SMTP details  as in the picture (label 2). \
Then create an SMTP credentials by clicking the "create My SMTP Credentials" as in the picture below.

![AWS connection details](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MaXDLP8OhkgvRCR2mmx%2F-MaXEHGge-kKjHrkBCWg%2FAdd%20AWS%20SES%20get%20SMTP%20details.jpg?alt=media\&token=ad38136f-83db-49dd-9171-61dd6cae6d4f)

The likes of AWS SES, SendGrid, SendinBlue do not provide IMAP. So you will need the IMAP of another mail provider like Google, Zoho, AWS Workmail, etc.\
A general rule is to use the IMAP of where you receive replies to your emails but we place no restrictions on this. You can use whatever IMAP you prefer.\
\
Also note, you can [create a filter ](https://help.murlist.com/email-warmup/how-to-create-email-filter/create-a-filter-for-gmail-gsuite)to keep your inbox productive and auto-archive emails from Murlist.


# Configure SendGrid

Steps on how to configure SendGrid SMTP for email warmup.

SendGrid has a pretty straightforward and standard SMTP configuration.<br>

|                    |                   |
| ------------------ | ----------------- |
| **Ports**          | 587               |
| **Username**       | apikey            |
| **Password**       | YOUR\_API\_KEY    |
| **Server \| Host** | smtp.sendgrid.com |

Yes, you have to enter the keyword "apikey" literally as the username. But you will need to create an API Key to use as the password.

Here is how to create an API key to use as the password for SendGrid:

Go to <https://app.sendgrid.com/guide/integrate/langs/smtp>

![How to create an API key to use as SendGrid SMTP password](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MdPjlv96NaxDVNBahoa%2F-MdPmjTLc3qOxYhkWSnh%2FSendGrid%20Screenshot.png?alt=media\&token=133abefa-94de-4655-8a22-a495a6468ac2)

Enter a name for your API key, this could be anything. It is just for your own identification then click "Create key". An API key will be generated.<br>

Once you have the API key, enter it as the password for your SendGrid SMTP setup at https:murlist.com/dashboard.\
\
You are all set!

The likes of AWS SES, SendGrid, SendinBlue do not provide IMAP. So you will need the IMAP of another mail provider like Google, Zoho, AWS Workmail, etc.\
A general rule is to use the IMAP of where you receive replies to your emails but we place no restrictions on this. You can use whatever IMAP you prefer.\
\
Also note, you can [create a filter ](https://help.murlist.com/email-warmup/how-to-create-email-filter/create-a-filter-for-gmail-gsuite)to keep your inbox productive and auto-archive emails from Murlist.


# Configure MailGun

Configuring Mailgun for warmup can be a little tricky considering it, like AWS SES, doesn't have an inbound IMAP.&#x20;

We permit using SMTP from one provider and an IMAP from another. So you can use SMTP from Mailgun and IMAP from any other service you like.

**Outgoing Mail (SMTP) Server**

* Server - smtp.mailgun.org (US) | smtp.eu.mailgun.org (EU)
* Port - *465* or *587*
* User - Your email
* Password - *Your API Key*

The likes of AWS SES, SendGrid, SendinBlue, Mailgun do not provide IMAP. So you will need the IMAP of another mail provider like Google, Zoho, AWS Workmail, etc.\
A general rule is to use the IMAP of where you receive replies to your emails but we place no restrictions on this. You can use whatever IMAP you prefer.\
\
Also note, you can [create a filter ](https://help.murlist.com/email-warmup/how-to-create-email-filter/create-a-filter-for-gmail-gsuite)to keep your inbox productive and auto-archive emails from Murlist.


# Configure Yahoo Mail

Configuring Yahoo mail for email warming requires only 2 steps.

Here are the configuration details for Yahoo Mail email warmup.

**Incoming Mail (IMAP) Server**

* Server - *imap.mail.yahoo.com*
* Port - *993*
* Requires SSL - *Yes*

**Outgoing Mail (SMTP) Server**

* Server - *smtp.mail.yahoo.com*
* Port - *465* or *587*
* Requires SSL - *Yes*
* Requires authentication - *Yes*

**Your login info**

* Email address - Your full email address (<name@domain.com>)
* Password - **Generate App Password**
* Requires authentication - *Yes*

Notice the password says "Generate App Password". This is means that you have to create a unique password to authenticate Murlist. This is pretty easy to do and involves just a few steps.

1. [Sign in to your Yahoo Account Security page](https://login.yahoo.com/account/security?.lang=en-US&.intl=us&.src=yhelp).
2. Click **Generate app password** or **Generate and manage app passwords**.
3. Enter your app's name in the text field.
4. Click **Generate password**.
5. Follow the instructions below the app password.
6. Click **Done**.


# How to create inbox filter


# Create a Filter Gmail/Gsuite

Step-by-step guide on creating a filter for your Gmail/Gsuite

Now that you have added your mailbox for warmup. It is important to create a filter to keep your inbox clean.\
This way you don't get to see emails from our network that might disrupt your workflow.

Here is a guide:

{% embed url="<https://youtu.be/Q8jGcTtk1_g>" %}
How to create a filter in Gmail and Google workspace.
{% endembed %}

Complete the following actions:

1. Select the configure icon on the search bar.
2. Enter the word "**mur**" in the subject field and click on the create filter button.
3. Mark the options **Skip the inbox**, **Mark as read**, **Never send to Spam**, **Always mark as important**, then choose **primary** in 'Categories as' field.

<br>


# Common errors


# Connection errors


# Google SMTP error

While trying to connect Google workspace email or the free Gmail account. You might run into a few errors. Here are possible solutions to make a fix:

1. Ensure you followed the guide [here](https://help.murlist.com/email-warmup/setup-and-configuration-guide/configure-gsuite-gmail-for-email-warming) correctly.
2. Ensure entries are correctly typed without whitespaces.
3. Did you get a security alert from Google? If yes, you will need to enable 2FA and get an app password.

Try to connect again. If this fails, then you will need to 2FA and get a unique password to connect to Murlist. This is also Google's recommended way of connecting to 3P apps not using its API.

### Turn on 2-Step Verification

1. Open your [Google Account](https://myaccount.google.com/).
2. In the navigation panel, select **Security**.
3. Under “Signing in to Google,” select **2-Step Verification** ![and then](https://lh3.googleusercontent.com/3_l97rr0GvhSP2XV5OoCkV2ZDTIisAOczrSdzNCBxhIKWrjXjHucxNwocghoUa39gw=w36-h36) **Get started**.
4. Follow the on-screen steps.

### Get a unique app password

1. Go to your [Google Account](https://myaccount.google.com/).
2. Select **Security**.
3. Under "Signing in to Google," select **App Passwords**. You may need to sign in. If you don’t have this option, it might be because:
   1. 2-Step Verification is not set up for your account.
   2. 2-Step Verification is only set up for security keys.
   3. Your account is through work, school, or other organizations.
   4. You turned on Advanced Protection.
4. At the bottom, choose **Select app** and choose the app you using ![and then](https://lh3.googleusercontent.com/3_l97rr0GvhSP2XV5OoCkV2ZDTIisAOczrSdzNCBxhIKWrjXjHucxNwocghoUa39gw=w36-h36) **Select device** and choose the device you’re using ![and then](https://lh3.googleusercontent.com/3_l97rr0GvhSP2XV5OoCkV2ZDTIisAOczrSdzNCBxhIKWrjXjHucxNwocghoUa39gw=w36-h36) **Generate**.
5. Follow the instructions to enter the App Password. The App Password is the 16-character code in the yellow bar on your device.

Once you get the app password, use it as the password for your connections.

You can always contact us via the chatbox on our website or send us an email at <support@murlist.com>. We will be glad to assist you further.

### <br>


# Errors with port 25

We enforce security across all our tools, hence port 25 which is often the only option for self-hosted emails might have some issues with connection. \
If you are using major mail providers, port 587 is most likely available. Use this instead as it is more secured.

If port 25 is the only available option on your server, here is how to connect anyways:

1. &#x20;Go to <https://murlist.com/dashboard>
2. Add using the older setup wizard to add your mailbox

![Connet port 25](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MhXLPRk-EtTiAN4tsgn%2F-MhXOM7kAguJ6RM4Uu7g%2FAdd%20port%2025.png?alt=media\&token=2ea3a48e-1273-4008-835f-2c4b287ed3b3)

If you need any help completing this step, we are always available on the chatbox on our website or you can send an email to <support@murlist.com>.


# Help fixing connection issues

Still experiencing connection issues? Here is what to do:

1. &#x20;Go to <https://murlist.com/dashboard>
2. Add using the older setup wizard to add your mailbox.

![](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MhXOmoKihObsd9c-UE2%2F-MhXR3nH8x8YI901ekGv%2FAdd%20port%2025.png?alt=media\&token=0e91c517-bdd7-4e39-8bf6-edfcdd8c24db)


# How to send video cold emails.

Here is a step by step  guide on sending video cold emails.

![A sample of the video email](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaR5Jb7OPFQMIjhzJ6g%2Fuploads%2FXKDjYeA4SRYWJ3cgwcUD%2FScreen%20Recording%202022-01-27%20at%2008.58.04%20pm.gif?alt=media\&token=25369a6c-640d-478b-9d30-86eef612d60f)

Sending a video email takes two steps.

1. [Generate a media list](/video-emails/how-to-send-video-cold-emails/how-to-create-media-list)
2. [Send a campaign](/video-emails/how-to-send-video-cold-emails/creating-a-campaign-with-video-email)

###


# How to create media list

A media list is the very foundation of media emails. Think of it as your prospect list with extra data. This data can be used to generate unique media files for each prospect on your list.

Go to Studio and follow the flow as in the video below.

{% embed url="<https://youtu.be/0d_LC_Vu78o>" %}
How to create a media list
{% endembed %}

#### Understanding expected fields

The media list requires you to upload an email list, a video and configure your video landing page CTA.

### Email list

Email lists are synced across the entire Murlist tools. This means that email lists uploaded for verification can be used for generating a media list email campaign.<br>

You will be required to upload an email list if you don't already have one, or select from a list of existing email lists.&#x20;

### Landing Video

This video will be used to create unique video landing pages. It is important to understand that this is where offers should be made. Most prospects watch this video so pay give it your best.

### Greeting video

This can be a mute video of just you waving at the camera. Should be around 10-20 seconds. This will be used for in-mail personalization

### Landing page CTA

You will be required to configure the landing page CTA button and the CTA link. For instance "Schedule a meeting" with a link leading to your website.

Depending on the template used, other fields might be required.

![](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaR5Jb7OPFQMIjhzJ6g%2Fuploads%2F7CODsOhXTIAwxMXXFbKh%2FImage-2022-01-27-at-8.29.46-PM.jpeg?alt=media\&token=7a37ab6e-d516-4776-a06a-b28c26742438)

We recommend using your own custom domain for the landing page. Ideally, you want the landing page domain to match with your sender domain. [Here is how to set up a custom domain](/drip-campaign/custom-domain/how-to-setup-domain-or-subdomain-for-video-landing-page) for the video landing page.

Once completed, head over to[ how to create a campaign with video email](/video-emails/how-to-send-video-cold-emails/creating-a-campaign-with-video-email) to start sending emails.


# Creating a campaign with video email

Learn the fundamentals of creating a campaign [here](/drip-campaign/how-to-create-a-drip-campaign).

To send a media email, you have to first create a media list. A media list is where you give us the data to use in sending emails to your prospects. Learn how to create a media list [here](/video-emails/how-to-send-video-cold-emails/how-to-create-media-list).&#x20;

Once you have your media list created, you will have to go to the create campaign section.&#x20;

Click [here](https://murlist.com/organizations/murlistfqehwym/campaign/create) to go to create a campaign. You can change the workspace if you need to.

### Select a list

![Select list for creating cold email campaign](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaR5Jb7OPFQMIjhzJ6g%2Fuploads%2Fcy9Wb15Mt4Au2EKjEMWe%2Fupload%20list.jpeg?alt=media\&token=e004d78e-48bf-4049-9dad-7ffd37a2a94d)

The first thing you will need to do is to select a list. This is important as the media list that will appear in the dropdown, the personalization tags will be filtered to only be from the list you select.

### Craft an email

![Select media list to create a media email](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaR5Jb7OPFQMIjhzJ6g%2Fuploads%2FPIZN4JvFEZZUfKPTZHGH%2FEmail%20campaign%20create%20-%20Murlist%20Portal%202022-01-31%20at%205.40.19%20pm.jpg?alt=media\&token=a60c3ac6-6e3d-46f8-a0ba-f090609bf106)

Click on the media list dropdown. You will see the media list associated with the email list you selected earlier.&#x20;

#### Can't find your media list in the dropdown?

{% hint style="info" %}
It is important to note that only the media lists associated with the email list you selected in the add email step will be available for selection.\
\
if this dropdown is empty, be sure you selected the right email list.
{% endhint %}

\
Once you have selected your list, everything else remains the same as sending a regular email as described [here](/drip-campaign/how-to-create-a-drip-campaign).


# Email verification

Documentation and guide on email verification features and how-to's

The Murlist email verification tool helps to validate the existence of a mailbox before attempting to send emails. This helps you avoid bounce, maintain a good sender reputation, and maximize the ROI on cold email outreach. \
We added this feature to help unify important steps to sending a successful campaign under one roof.

#### Ways to verify email:

There are just two ways to verify an email list, the email verification search bar, and the upload email list method. The email verification search bar is primarily for verifying emails one by one. Only the resulting message is returned.\
Bulk upload on the other hand allows you to verify an email list using csv.&#x20;

### Single email verification with search bar:

![Single email validation with search bar](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MdtKWeSNYltdJgONXMX%2F-MdtW7aCR5LF_rVEYxXD%2Fsingle%20email%20validation%20with%20search%20bar.jpg?alt=media\&token=c1e3edc6-257c-4626-a134-7a4d2bde8756)

### Bulk email verification:

To verify an email list, upload a CSV by clicking on the upload list button and following the guide:

![](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaR5Jb7OPFQMIjhzJ6g%2Fuploads%2FVQK1nCpfnwokNsnrw6CC%2Fhow-to-upload-a-list.jpeg?alt=media\&token=0dd5a3d0-a78b-4dd6-bd81-f78e2d691ec2)

The lists you uploaded here can be used to create a campaign. You can launch a campaign to only send to prospects who pass the verification or to all prospects.&#x20;


# How to download email list after verification

Once the verification completes for a list, the download option appears on the list.

### Step one: Click on download after verification

![How to download email list after verification](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MgNE6I3vQunp4s6Ys-u%2F-MgNGJua4MWmDmYDUwOm%2FEmail%20download.png?alt=media\&token=4021e70a-08e2-408d-9356-06a1f4e4e92d)

### Step two: Select option:

![Select download email list option](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MgNE6I3vQunp4s6Ys-u%2F-MgNHDPxGfyfvvEkLWtv%2FDownload%20Options.png?alt=media\&token=75706b03-3833-4812-9b35-0e8b2c21ef9b)


# Analytics for email verify result.

Once the verification completes for a list, the download option appears on the list.

![Analytics for email verify result.](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MgNOKKkaqGwOWGzvRB5%2F-MgNOljhAbdxeJtPQJMH%2FEmail%20list%20analytics.png?alt=media\&token=bdb67377-ebdd-4f49-8dfd-5d233e4c3b39)

#### Click on view analytics

![View email verify analytics](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MgNOKKkaqGwOWGzvRB5%2F-MgNPFMOLwDkY9j7HfjO%2FView%20email%20list%20analytics.png?alt=media\&token=c3fcf373-f79d-41a6-80c8-7924ec40e78b)


# What is Lead Engine

What is lead engine? How does it work? What are the unique features.

What is leads engine?

Leads engine is an automated lead generation solution that ensures you never run out of leads.

Leads comprise of products like knowledge graphs, AI-powered recommendations, web lead analysis that work together to make you never run of leads for your business.

The leads engine has deep integration with the Murlist products, for instance. You can define an audience on the lead engine and automatically reach out to them through The Drip campaign while validating their contact information with Email Verify.

Lead engine support incrementally leads to any campaign running on the drip campaign. This works automatically indefinitely until you turn it off, ensuring a constant reliable supply of fresh leads for your business at zero efforts.


# Web leads


# How does web leads work?

What is web leads and how does it work? Here are the answers to question you may have.

The Murlist's Web Lead is an automated way to generate leads from your website by identifying where your visitors work.

We analyze your website traffic and build a customer persona based on details like visitor's company, industry, region, time spent on site.

Our AI uses this information to automatically suggest similar companies and leads.


# How to create web property

A comprehensive guide on how to create web properties for the web lead tracking.

Web properties are individual Web Lead instances that provide a unique tracking code. This could be added to a web app or a website. \
\
Each instance is independent of the other. Instances should be created for one project or startup. Say you are working on Murlist, you will have to create just one property for Murlist and add the code on all user-facing websites and web apps owed by Murlist to centralize the leads generated. \
In this case, one instance will be created for <https://murlist.com>, help.murlist.com, support.murlist.com. You get the idea.

To create a web property, go to the [lead manager](https://murlist.com/leadengine/web-leads).

Click on "create new property" as in the picture below:

![Click on create new leads properties.](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MjMcVhcCHSwMdUsPswv%2F-MjMdb9M8hz8-42yQAB5%2FFirst%20create%20web%20property.png?alt=media\&token=83af6216-5c8e-4a33-8148-d1271ff47a67)

Give the property a name. This could be anything, it is meant for your identification only.

![](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MjMcVhcCHSwMdUsPswv%2F-MjMeH3nOBMrGwxghrtQ%2FSecond%20create%20web%20property.png?alt=media\&token=0b672f6f-355c-4a1c-becb-b7ec7f2261da)

Add the domains authorized to send leads to this property

![](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MjMcVhcCHSwMdUsPswv%2F-MjMeeaZWnksCbHMsgLo%2FThird%20create%20web%20property.png?alt=media\&token=589f8780-4b1a-44a6-9997-8258450a4c91)

That's all. Now head over to the [integration guide here](https://help.murlist.com/murlist-lead-engine/web-leads/how-to-integrate-web-leads-pixel) to learn how to add your website to the leads.


# How to integrate web leads pixel

How to integrate The Web Leads pixel on your app or website.

To get started with The Web Leads, you will have to complete these two steps.

* Create a web property.
* Add the pixel to your app.

### Create a web property

To learn more about web property and how to create one, follow the guide [here](https://help.murlist.com/murlist-lead-engine/web-leads/how-to-create-web-property).

### Add the pixel to your web app or website.

Upon creation of web property, a unique tracking pixel will be generated. You can see it by clicking on the setup details as in here:

![Click on setup details](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MjMYviAbX1PiBunPdBe%2F-MjM_kqFLF48aRcsbgCJ%2FFirst%20step%20to%20integrate%20the%20lead%20tracking%20%20pixel.png?alt=media\&token=6035b101-01ac-43f9-901d-fa6cb5350d36)

Next, copy the pixel:

![copy the Murlt's web leads tracking](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaR5Jb7OPFQMIjhzJ6g%2F-MjMYviAbX1PiBunPdBe%2F-MjMaEcxdL77219n-Zvc%2FSecond%20step%20to%20integrate%20the%20lead%20tracking%20%20pixel.png?alt=media\&token=97b790fb-d1e0-4d3a-beb9-52422ec8e0d2)

The next step is to add this to **the head tag** of your website or web application.

That is all.&#x20;

N.B: The default pixel looks like this:

```
<script async defer data-domain="engine.murlist.com" src="http://engine.murlist.com/yourId" />
```

But can also be implemented this way:

```
(function(m,u,r,l,i,s,t){
           m[r]=m[r]||function(){(m[r].q=m[r].q||[]).push(arguments)};
            s=u.createElement(l);s.async=1;s.src="http://engine.murlist.com/"+i;
            t=u.getElementsByTagName(l)[0];t.parentNode.insertBefore(s,t);
        })(window, document, "murlist", "script", "yourId")
```

Replace "yourId" in the sample code above with the web lead property's ID you wish to integrate.


# Configure SPF, DKIM & DMARC


# How to set up Google workspace SPF, DKIM & DMARC

A complete guide on how to set up and configure SPF, DKIM & DMARC for Google workspace.

In this guide, we will go over how to configure and set up SPF, DKIM, and DMARC for your Google workspace and why it is important. We will try to avoid details on how SPF, DKIM & DMARC work but will provide necessary information on how and why to set them up.

Before we start it is important to note that SPF, DKIM, and DMARC are all TXT records on your DNS and hence publicly available. So you wouldn't want to enter any information like a personal email address that you'd otherwise want to keep private.

Why should you set up this?

SPF, DMARC & DKIM are records that are used to validate if emails actually came from you and that they haven't been tampered with.&#x20;

### SPF (Sender Policy Framework):

This publicly announces the IPs allowed to send emails. A way of saying; "email is from me if it was sent from these IPs".

For SPF, create a DNS record pointing to:&#x20;

```
v=spf1 include:_spf.google.com ~all
```

Here is an example, only that this one is for Zoho. It should look like this when you are done. Murlist.com, as in the example below, should be your domain instead.

![SPF Example](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaR5Jb7OPFQMIjhzJ6g%2Fuploads%2FN3jy334FJ9Lz4SxZhJ5P%2FScreenshot%20\(8\).png?alt=media\&token=f748c5c7-40d8-42ab-b84e-ce074a0b586d)

### DKIM (Domain Key Identified Mail)

Domain Key Identified Mail (DKIM) is used to allow the receiver mailbox to verify that the email you sent hasn't been tampered with in any form. This is important in making sure it wasn't maliciously changed in transit. Unlike SPF, DKIM is unique for each account. Chances are you already have this one set up in the initial configurations.

Steps to configure DKIM for Google workspace:

* Go to your [Google Admin](https://admin.google.com/):&#x20;
* Locate Gmail under App settings (App settings > Gmail > DKIM authentication)
* Click on "Generate new record"

Then go ahead and add the record in your DNS as a TXT record. Please do note that it might take a while for the changes to propagate.

### DMARC:

For DMARC, create a DNS TXT record named `_dmarc` pointing to:&#x20;

```
v=DMARC1; p=quarantine;  pct=90; sp=none
```

![](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaR5Jb7OPFQMIjhzJ6g%2Fuploads%2FDwUyAB9wBoG0kpzqTzuN%2Fdmarc%20example.png?alt=media\&token=74422491-a04d-4f61-8ca7-bd98536fb996)

After saving your changes, do give it some time to propagate and you should be all set now.

If you have any issues completing the guide, be sure to reach via the chatbox on our website or email <support@murlist.com> and we will be glad to help.


# Zapier Intergation

Zapier integration with Murlist is currently in a public invite-only. This means that you will need to use the link on your account to be able to add create a zap with Murlist.\
\
Click on "Get started" as in the picture below to continue.

![](https://1629072980-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaR5Jb7OPFQMIjhzJ6g%2Fuploads%2FQ6yStTutadqHlKWxbQ6J%2Fzapier%20integration%20guide.jpeg?alt=media\&token=6ce89e21-0868-464e-bb5e-9766160ff1c6)


# API Authentication

How to authenticate all API requests

All requests to the API endpoint must be authenticated with the workspace API key. Please note that API keys are unique to each workspace.

### How to get your workspace API key:

1. Log in to your account.
2. Select the workspace.
3. Go to settings, and select API Key.

From here you can create an API Key, or regenerate a new key. Once a new key is generated, the previous API key is made invalid.

> To authenticate any of your request, attach the API key in the request header as X-API-KEY

That's all, every request should work fine now.

<br>


# Email Validation API

Validate email using the API

Endpoint:

```
https://api.murlist.com/validate
```

Required data:

In the request body, include data as follows:

```
{
    "email": "example@testemail.com"
}
```

#### Understanding the required data:

`email:` The email you wish to validate.


# Campaign API

Comprehensive documentation on the campaign API.

1. [List all campaigns](/api-documentations/campaign-api/list-all-campaigns)
2. [Add prospect to campaign](/api-documentations/campaign-api/add-prospect-to-campaign)


# List all campaigns

How to list all campaigns on a workspace

To list all the campaigns in a workspace, you need to make a get request API call to the following endpoint:

```
https://api.murlist.com/campaign/all
```

\
A list of all the campaigns, including completed and paused camapigns, will be returned.&#x20;


# Add prospect to campaign

Add new prospect to an existing campaign

Endpoint:

```
https://api.murlist.com/campaign/prospects/add
```

Required data:

In the request body, include data as follows:

```
{
    "campaign": "txxxxxxsiidoS8w8YER7xxxxxZBFV", //the campaign Id
    "prospect_email": "ik82i@yahoo.com", 
    "other_fields": {"name": " Ikenna Paschal", "anyKey": "anyValue"},
    "verify_email": true //false
}
```

#### Understanding the required data:

`campaign:` This should be the id of the campaign you want to add the prospect to. This can be gotten by calling the [list campaign API](/api-documentations/campaign-api/list-all-campaigns) which returns campaigns and their ids

`prospect_email`: This should be the email of the prospect you wish to add to an existing campaign.

`other_fields`: This should be an object(dictionary) of other attributes of this prospect like age, name, location. A combination of key/value pairs.\
These attributes are used in personalization.

`verify_email`: This verifies the prospect's email before adding them to a campaign if set to true and will skip verification if set to false. \
important to mention that the decision to send to prospect based on the verification status is made at the campaign level, during the campaign creation configuration.

#### What this API returns:

On successful addition, the API should return a status code 201, with the message, "Added successfully".\ <br>

If you need any help in implementing this API, be sure to reach out to us at <support@murlist.com>. We are always happy to help.


