# Sendwithus Integration


Connect your Sendwithus account to Dyspatch to take advantage of Dyspatch’s email creation features and automatically export emails to Sendwithus when approved and published.

## Connect your Sendwithus Account

### Create a Sendwithus API Key

Once you have your Sendwithus API key you are ready to set up your Sendwithus integration in Dyspatch. 

To get started, navigate to the <a href="https://app.sendwithus.com/#/api_settings" target="_blank">API Settings page</a> in Sendwithus and create a Production API key. For security reasons, the key can only be displayed once, so be sure to copy your key before closing the window.

<img class="img-border" src="https://docs.dyspatch.io/img/integrations/swu-new-api-key.png" alt="Creating a new API key in Sendwithus"/>

### Add Sendwithus Integration to Dyspatch

In Dyspatch, select **Add Integration** on the <a href="https://app.dyspatch.io/admin/integrations/email" target="_blank">Admin > Integrations</a> page.

![Arrows to add integration button in admin dashboard](https://docs.dyspatch.io/img/integrations/apps-integration-add-integration.png)

<div class="highlight note"> You may need to unlock integrations for your team's account. Reach out to our <a href="mailto:support@dyspatch.io">support team</a> to get integrations set up.</div>

Select **Sendwithus** from the **Choose an Integration** dropdown, enter your API key and include a short description for your team.

<img class="img-border" src="https://docs.dyspatch.io/img/integrations/swu-add-integration.png" alt="Adding a new Sendwithus Integration in Dyspatch"/>

Next, optionally add a default From Name and Address for the integration. If set, this can be overridden for individual emails from the metadata tab in the email builder.

<img class="img-border" src="https://docs.dyspatch.io/img/integrations/swu-add-integration-2.png" alt="Adding a default name and address in the second ESP integration modal for a new Sendwithus Integration in Dyspatch"/>

Lastly, toggle on the workspaces you'd like to enable exporting with this integration from, and click add integration.

<img class="img-border" src="https://docs.dyspatch.io/img/integrations/swu-add-integration-3.png" alt="Toggle for workspaces included in the third ESP integration modal for a new Sendwithus Integration in Dyspatch"/>

### Working with Emails

Once your new integration has been set up, you can begin working in Dyspatch — our article on [Getting Started](https://docs.dyspatch.io/emails/getting_started/) in Dyspatch is a good place to start.

Once an email has gone through the [approval process](https://docs.dyspatch.io/emails/submitting_an_email/) and been published, it will automatically be exported to your Sendwithus account.

<img class="img-border" src="https://docs.dyspatch.io/img/integrations/swu-auto-export.png" alt="Dyspatch Email Builder showing that the email has been exported to Sendwithus"/>

If necessary, you can also manually trigger the export to your Sendwithus account by clicking the **Export** button, choosing **Export to Integration**, and selecting your Sendwithus Integration. Rename your email by editing the Email Name field if you would like, and then click **Confirm & Export** to export your email to Sendwithus. 

The first time you export a Dyspatch email, a new template will be created in your Sendwithus account using the Email Name you entered. All future exports will update the published version of that email, using the entered Email Name as the version name.

<img class="img-border" src="https://docs.dyspatch.io/img/integrations/swu-manual-export.png" alt="Entering a name for your exported email"/>

### Setting Up AMP?

<div class="highlight note">
If you are interested in <a href="https://docs.dyspatch.io/apps/getting_started_with_amp/">sending AMP emails</a> or using any of our <a href="https://docs.dyspatch.io/apps">apps</a>, please <a href="mailto:support@sendwithus.com">contact us</a> to learn more about enabling AMP for your Sendwithus account.
 </div>

## Video Walkthrough

Want to see our Sendwithus integration in action?  Check out our video walkthrough!

<iframe width="560" height="315" src="https://www.youtube.com/embed/BYChMZtFWhY" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
<br/>