> For the complete documentation index, see [llms.txt](https://documentation.crossengage.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.crossengage.io/data-and-engagement-platform/messages/integrations/channels/email/sendgrid-by-twilio/set-up-sendgrid-integration.md).

# Set up SendGrid Integration

Before you begin, you will need the following:

* SendGrid Account
* CrossEngage Account
* User data (including an email address)

## **Creating a New API Key** 

A SendGrid API key allows CrossEngage to connect to your SendGrid account. To create the API key:

* [*Log in*](https://app.sendgrid.com/login) to your SendGrid account.
* Unfold `Settings` in the left panel menu and click on the `API Keys` section.
* In the top right corner of the page, click `Create API Key`.

<figure><img src="https://985110910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hio8LJewN8lQY2Vlqy0%2Fuploads%2FRyMKwMnbQmusdiRiyasQ%2FSendgrid_Settings.png?alt=media&amp;token=1ab6ac00-be65-43e6-98f9-f63538a918db" alt=""><figcaption></figcaption></figure>

* To make the API Key easily identifiable, name it descriptively in the "API Key Name" field.
* Set the highest possible access which is "Full access".&#x20;
* Click `Create & View`.&#x20;

<figure><img src="https://985110910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hio8LJewN8lQY2Vlqy0%2Fuploads%2Fmhjm7iqmKBfv69mmu2uI%2FSendGrid_CreateKey.png?alt=media&amp;token=2bb81e47-df67-4090-bcc9-becd9de61ff2" alt=""><figcaption></figcaption></figure>

* If you wish to integrate Sendgrid without allowing Full Access, the following permissions must be enabled:
  * Read access to IP Management
  * Read access to Template Engine
  * Full access to Mail Send

<figure><img src="https://985110910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hio8LJewN8lQY2Vlqy0%2Fuploads%2FRlpmOWIp3nGkEiSliyqX%2FSendGrid_Permissions.png?alt=media&amp;token=959a6b3a-97d8-41f9-b74e-1b9d47b681f3" alt=""><figcaption></figcaption></figure>

* Copy the API key, by clicking on the API key line and then click `Done`. The API key will be used later for the integration.

{% hint style="info" %}
The SendGrid API key will only be shown to you during the set-up process. You should copy and paste it into a safe place for future reference.
{% endhint %}

## Configuring a SendGrid Integration in CrossEngage

* In the CrossEngage app, navigate to `Settings` > `Integrations`.
* Click the `Add new integration` button in the top right corner of the page.

<figure><img src="https://985110910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hio8LJewN8lQY2Vlqy0%2Fuploads%2FAgS47R9XoM50Wg0ysO8G%2FIntegrations_new.png?alt=media&amp;token=f0b23923-4d5f-4b08-85d8-b97df995be9f" alt=""><figcaption></figcaption></figure>

* Search for SendGrid, then click `Set up`. An integration set-up form will open.

<figure><img src="https://985110910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hio8LJewN8lQY2Vlqy0%2Fuploads%2FBMbHaru1p7f3A5z3umac%2FIntegrations_SendGrid.png?alt=media&amp;token=ed3b484d-eae2-4d21-b1a0-f78e3faf18f1" alt=""><figcaption></figcaption></figure>

* Enter a clear, descriptive name for your integration in the "Account name" field.
* Paste the API Key that you copied from your SendGrid account during the previous steps into the "API key" field.
* Click `Connect` and then `Save` to save your integration.

{% hint style="info" %}
SendGrid will assign a default IP Pool to your account if you do not choose one.
{% endhint %}