> ## Documentation Index
> Fetch the complete documentation index at: https://hub.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sendgrid

> Follow these steps to connect Sendgrid with StackOne Hub successfully.

<Warning>
  Ensure you have Owner privileges for your Sendgrid account.
</Warning>

If you've been directed to StackOne to integrate with Sendgrid, the following steps will help you understand the process and any necessary actions to configure successful integration.

## Generating an API key

<Steps>
  <Step title="Sign in to Sendgrid">
    Sign in to the Sendgrid Dashboard.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Sendgrid Dashboard" src="https://mintcdn.com/stackone-hub/TJXu2uA7nDGkPLKz/images/sendgrid/image1.png?fit=max&auto=format&n=TJXu2uA7nDGkPLKz&q=85&s=c5b1ff3fb503d61360576edfa9bb929a" width="400" height="726" data-path="images/sendgrid/image1.png" />
    </Frame>
  </Step>

  <Step title="Go to Settings">
    Click on the Settings dropdown and select API Keys.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Sendgrid settings" src="https://mintcdn.com/stackone-hub/TJXu2uA7nDGkPLKz/images/sendgrid/image2.png?fit=max&auto=format&n=TJXu2uA7nDGkPLKz&q=85&s=75f8a397bffd32cc7601f532d6fd2210" width="252" height="482" data-path="images/sendgrid/image2.png" />
    </Frame>
  </Step>

  <Step title="Generate the API Key">
    To Generate the API Key, click the **Create API Key** button

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="API Key" src="https://mintcdn.com/stackone-hub/TJXu2uA7nDGkPLKz/images/sendgrid/image3.png?fit=max&auto=format&n=TJXu2uA7nDGkPLKz&q=85&s=d8694b75c3d630d87229b7763e976034" width="1887" height="674" data-path="images/sendgrid/image3.png" />
    </Frame>
  </Step>

  <Step title="Configure permissions">
    Enter the API Key Name and select **Full Access** under *API Key Permissions*.

    Click **Create & View** to generate the API Key.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Permissions" src="https://mintcdn.com/stackone-hub/TJXu2uA7nDGkPLKz/images/sendgrid/image4.png?fit=max&auto=format&n=TJXu2uA7nDGkPLKz&q=85&s=f75ff85167956d691512e10a44d5f9a6" width="1818" height="1298" data-path="images/sendgrid/image4.png" />
    </Frame>
  </Step>

  <Step title="Copy the API Key">
    Copy your new API Key to a safe place to be used in the next step.

    Click <b>Done</b> in the bottom once complete.

    <Warning>
      The API Key is not created until you click the <b>Done</b> button.
    </Warning>

    <Frame>
      <img className="rounded-md" style={{ width: '400px', margin: '0 auto', border: '1px solid #efefef' }} alt="API Key dialog" src="https://mintcdn.com/stackone-hub/TJXu2uA7nDGkPLKz/images/sendgrid/image5.png?fit=max&auto=format&n=TJXu2uA7nDGkPLKz&q=85&s=c4a48e735df4ec6538401eaa1b2d11c2" width="1665" height="408" data-path="images/sendgrid/image5.png" />
    </Frame>
  </Step>
</Steps>

## Use the API Key in the StackOne Hub

Upon reaching the Link Account page, enter the generated API key and proceed by clicking the <b>Connect</b> button.

<Frame>
  <img className="rounded-md" style={{ width: "400px", margin: "0 auto", border: "1px solid #efefef" }} alt="Access Token Created" src="https://mintcdn.com/stackone-hub/TJXu2uA7nDGkPLKz/images/sendgrid/image6.png?fit=max&auto=format&n=TJXu2uA7nDGkPLKz&q=85&s=a3dc12113ad6f10323c006dd392c0e1f" width="486" height="495" data-path="images/sendgrid/image6.png" />
</Frame>

## Available data

This integration has the following [IAM Resources](https://docs.stackone.com/reference/iam_list_users) available from the provider:

<ul>
  <li>Users</li>
  <li>Roles</li>
</ul>

## Useful Links

<Card title="API Reference" icon="link" href="https://www.twilio.com/docs/sendgrid/api-reference/how-to-use-the-sendgrid-v3-api">
  [https://www.twilio.com/docs/sendgrid/api-reference/how-to-use-the-sendgrid-v3-api](https://www.twilio.com/docs/sendgrid/api-reference/how-to-use-the-sendgrid-v3-api)
</Card>