# Integrating with EmailOctopus

Directly connect your Emailable and EmailOctopus accounts.

## **Connecting to EmailOctopus**

After signing in to your Emailable account, click the **Get Started** button, or the **+ New List** if you have already verified a list with us. A new modal will appear, prompting you to select a list source.

![Email verification platform “Select a source” screen showing multiple integrations with EmailOctopus highlighted as an option to import email lists.](https://cdn.sanity.io/images/6ukvxgr7/production/f37b564f22af3ebaa87b9f243823d442524df558-1551x780.png)

Click the EmailOctopus option, then copy & paste your **API key** from your EmailOctopus account into the text box provided.

![EmailOctopus integration setup screen prompting user to enter API key from Integrations and API settings to connect account.](https://cdn.sanity.io/images/6ukvxgr7/production/0fece54f99b2585f02193c97c2a6ab0ae5f546b4-1798x908.png)

## **Verifying an EmailOctopus List**

Once access has been granted, you'll be prompted on your Emailable dashboard to select a list from your existing EmailOcotopus Contacts.

![EmailOctopus account successfully connected in email verification tool with account name displayed and option to add a new account.](https://cdn.sanity.io/images/6ukvxgr7/production/227808f5c896d37791782826586b47cf84672f63-1798x908.png)

![EmailOctopus list selection screen showing “Emailable-Validation” list with total email count ready for import into verification tool.](https://cdn.sanity.io/images/6ukvxgr7/production/3987a6ad735698e4153a43a55cae7634edd02780-1798x908.png)

After importing the list, click **Verify **to watch it verify in real time.

![Verification screen displaying EmailOctopus list with 198 emails ready and a “Verify” button to start email validation process.](https://cdn.sanity.io/images/6ukvxgr7/production/38be81d9c4da15331d2ce43b53fff176b6e8f86e-857x1254.png)

Once verification is complete, click **View Results** to view and analyze the health of your EmailOctopus data.

![Email verification results preview showing 65.7% deliverable rate for EmailOctopus list with option to view detailed results.](https://cdn.sanity.io/images/6ukvxgr7/production/576b324edacd5819431c065bde92cca7e1e98757-853x1252.png)

## **Export Data Back to EmailOctopus**

In the results page, you'll find the **Exports **tab at the top of the dashboard. 

![Verification dashboard displaying EmailOctopus email list results with breakdown of deliverable, undeliverable, risky, unknown, and duplicate emails.](https://cdn.sanity.io/images/6ukvxgr7/production/2ab8de73f5af886a7d7265cd0d2b09a093f39e68-1579x934.png)

Click the **New Export** option.

![Exports page in email verification platform showing no existing exports and option to create a new export.](https://cdn.sanity.io/images/6ukvxgr7/production/81bed361cb706739639468e953f2704a9501d701-1764x436.png)

A new modal will appear, allowing you to include or exclude specific verification categories and filters in your export. After making your selection, click **Send To EmailOctopus.**

Choose the option that best suits your needs.


| Export Option | Included Email States |
| --- | --- |
| Maximum Deliverability | This export contains Deliverable emails |
| Maximum Reach | This export contains Deliverable, Risky, and Unknown emails |
| Only Bad Emails | This export contains Undeliverable emails |
| Custom | Build your customized export report |


![Export configuration screen allowing users to send verified email contacts back to EmailOctopus with filtering and attribute selection options.](https://cdn.sanity.io/images/6ukvxgr7/production/d3b0759f3136c0c37484cb5876c94702cfcd9fcc-1652x1780.png)

You'll receive a notification that the export is being sent to EmailOctopus, and you'll receive an email notification once the export is complete.

### **Exported Results in EmailOctopus**

When you export the verified emails to EmailOctopus, the selected emails will be sent to your EmailOctopus account, while other unselected email contacts will be unsubscribed and will have a field called "Emailable Unsubscribed" set to "true".

For example, if you select only the Deliverable emails in Emailable, those deliverable emails will be added to your selected list in EmailOctopus. All other contacts will be unsubscribed and will have a field called "Emailable Unsubscribed" set to "true".


