# Onboarding

## Onboarding

The Braze integration connects to EdgeTag using a REST API key. This guide walks you through creating the key in Braze and activating the channel in EdgeTag.

## Video Guide

#### Step 1: Create a REST API Key in Braze

1. Log in to your [Braze Dashboard](https://dashboard.braze.com)
2. Go to **Settings → Developer Console → API Keys**
3. Click **Create New API Key**
4. Give it a name, e.g. `EdgeTag`
5. Under **Permissions**, enable `users.track`
6. Click **Save API Key** and copy the key

{% hint style="info" %}
The API key only requires the `users.track` permission. Do not grant broader permissions than needed.
{% endhint %}

#### Step 2: Find Your REST Endpoint

Your REST endpoint is specific to the Braze cluster your account is hosted on.

1. In Braze, go to **Settings → Developer Console**
2. Copy the **REST Endpoint** shown at the top of the page — it looks like `https://rest.iad-01.braze.com`

| Cluster | REST Endpoint                   |
| ------- | ------------------------------- |
| US-01   | `https://rest.iad-01.braze.com` |
| US-02   | `https://rest.iad-02.braze.com` |
| US-03   | `https://rest.iad-03.braze.com` |
| US-04   | `https://rest.iad-04.braze.com` |
| US-05   | `https://rest.iad-05.braze.com` |
| US-06   | `https://rest.iad-06.braze.com` |
| US-08   | `https://rest.iad-08.braze.com` |
| EU-01   | `https://rest.fra-01.braze.eu`  |
| EU-02   | `https://rest.fra-02.braze.eu`  |

#### Step 3: Add the Channel in EdgeTag

1. Log in to your [EdgeTag Dashboard](https://app.edgetag.io)
2. Navigate to **Channels** and click **Add Channel**
3. Search for **Braze** and select it
4. Enter a name for this channel — choose something descriptive to help with debugging if issues arise

<figure><img src="https://1474399258-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZJWZKbUk0hRISkCIj2p4%2Fuploads%2Fl1HokCDq52E1ciNBdUUT%2Fimage.png?alt=media&#x26;token=b424212b-7dbf-4f36-b474-1182faa8ecc3" alt=""><figcaption></figcaption></figure>

#### Step 4: Enter Your Credentials

Fill in the two required fields:

| Field             | Value                                            |
| ----------------- | ------------------------------------------------ |
| **API Key**       | The REST API key from Step 1                     |
| **REST Endpoint** | The endpoint URL from Step 2 — no trailing slash |

Click **Save & Deploy**

Congratulations, the basic setup is now complete. Let's proceed to the next section to explore additional configuration options.