# 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.

![Creating a new API key in Sendwithus](https://docs.dyspatch.io/img/integrations/swu-new-api-key.png "class: idm img-size-75")

### 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.

![Adding a new Sendwithus Integration in Dyspatch](https://docs.dyspatch.io/img/integrations/swu-add-integration.png "class: idm img-size-75")

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.

![Adding a default name and address in the second ESP integration modal for a new Sendwithus Integration in Dyspatch](https://docs.dyspatch.io/img/integrations/swu-add-integration-2.png "class: idm img-size-75")

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

![Toggle for workspaces included in the third ESP integration modal for a new Sendwithus Integration in Dyspatch](https://docs.dyspatch.io/img/integrations/swu-add-integration-3.png "class: idm img-size-75")

### 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.

![Dyspatch Email Builder showing that the email has been exported to Sendwithus](https://docs.dyspatch.io/img/integrations/swu-auto-export.png "class: idm img-size-75")

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.

![Entering a name for your exported email](https://docs.dyspatch.io/img/integrations/swu-manual-export.png "class: idm img-size-75")

### 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/>