> 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**&#x20;

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="/files/s616gb6TSW5vE27kwHrS" 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="/files/6BU01ZzSXpTfPkNhn5o9" 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="/files/VK5yZM05hHNtUA9bcCLx" 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="/files/zfWLFaM1kVBGbSAJoguR" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/FMU9qKygZCaZHwFFWola" 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 %}
