# Heroku Connection

Providing a Heroku API key and configuring storage is all that is required to manage a GRAX deployment in your Heroku account.

## Heroku Portal

1. Navigate to the [Heroku Dashboard](https://www.heroku.com) and login with a user that has the necessary access to the team that will be used to host the GRAX deployment.
2. Click on the profile in the upper right corner and choose "Account Settings"

   ![Account Settings](https://3330797634-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqjG14Rorm2T7JgMy0hrc%2Fuploads%2FORGZcGliA5eGLbfoz2bg%2Fheroku-account-settings.png?alt=media\&token=e20f0db5-6e47-400e-aba9-1062318a4255)
3. Scroll down to the section titled "API Key"

   ![API Key](https://3330797634-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqjG14Rorm2T7JgMy0hrc%2Fuploads%2FaFtHDq7lJKZCFHA41lMW%2Fheroku-api-key.png?alt=media\&token=56a8ec40-d4ea-49b8-9510-06c901f9768e)
4. Click `Reveal`
5. Copy the API key

## Configuring the Connection in GRAX

On the GRAX Platform team you'd like to use for creating a deployment, navigate to the `Connections` tab and click `Connect Heroku`. Fill in the following values:

* `API Key`: Use the API key from the Heroku Dashboard

Click `Save` to save the connection.

![New Heroku Connection](https://3330797634-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqjG14Rorm2T7JgMy0hrc%2Fuploads%2FDRNJRlHxviilOtUsr1Fr%2Fnew-heroku-connection.png?alt=media\&token=3104316e-62b1-4840-9bbc-b69688d0dd0d)

## Deployment Configuration

Once a Heroku Account has been connected a Deployment can be created.  Navigate to the `Deployments` tab and click `New Deployment`. In the Advanced Settings, fill in the Heroku Team and Space names:

* `Enterprise Team Name`: enter the Heroku Team Name
* `Enterprise Space Name`: enter the Heroku Space Name

Click `Save` to create the deployment.

<figure><img src="https://3330797634-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqjG14Rorm2T7JgMy0hrc%2Fuploads%2FPbB1tOBdXHhDeUtfHG9X%2FHeroku_Deploy_Config.png?alt=media&#x26;token=85ebb924-b387-49ca-8051-4ebe26542703" alt=""><figcaption><p>New Heroku Deployment</p></figcaption></figure>