# 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="/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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.crossengage.io/data-and-engagement-platform/messages/integrations/channels/email/sendgrid-by-twilio/set-up-sendgrid-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.