# SendGrid

platforma citește colegii de echipă ai contului dvs. SendGrid prin intermediul SendGrid v3APIastfel încât să puteți verifica cine are acces.

Creați cheiaAPIcu **Full Access**, sau cu **Custom Access** și permisiunea **Teammates** setată la cel puțin **Read Access**. O cheie **Billing Access** nu va funcționa: ajunge doar la punctele de facturare ale contului, nu la punctele de facturare ale colegilor de echipă pe care le citește platforma :::

## Prerequisites

- accesul administratorului organizației platformei - deținătorul contului SendGrid sau accesul administratorului (un administrator deține fiecare domeniu de aplicare, inclusiv permisiunea colegilor de echipă pentru nevoile cheie)

## Collected Fields

| the platform field | SendGrid field                                           | Notes                                                                                                                                                                                                                      |
| ----------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name        | `first_name`, `last_name`                                | Joined into a single name, and left empty when SendGrid holds neither                                                                                                                                                      |
| Email       | `email`                                                  |                                                                                                                                                                                                                            |
| Role        | `user_type`                                              | `owner` becomes Owner, `admin` becomes Admin, `teammate` becomes Teammate. When SendGrid returns no `user_type`, the role falls back to Admin or Teammate according to `is_admin`. Any other value is passed through as is |
| Admin       | `is_admin`                                               | Flagged as an administrator when `is_admin` is true                                                                                                                                                                        |
| Status      |  |                                                                                                                                                                                                                            |
| MFA         | `scopes`                                                 | Read from the per-teammate detail endpoint. `2fa_required` on its own reports MFA enabled and `2fa_exempt` on its own reports it disabled. Both flags together, neither flag, or a failed detail fetch report unknown      |
| Last login  |  |                                                                                                                                                                                                                            |
| External ID | `username`                                               | Stable identifier used to track the account across reviews. On a unified teammate it is the email address                                                                                                                  |
| Created at  |  |                                                                                                                                                                                                                            |

Proprietarul contului apare alături de colegii de echipă. platforma trece orice rând care nu poartă o adresă de e-mail.

## Step 1: Create an API Key

1. In the [SendGrid app](https://app.sendgrid.com/settings/api_keys), signed in as the account owner or an administrator, go to **Settings** > **API Keys**.
2. Click **Create API Key**, name it (e.g. `Probo Access Review`), and select **Full Access**, or **Custom Access** with the **Teammates** permission set to **Read Access**.
3. Click **Create & View**, copy the key (`SG.…`), and store it securely. SendGrid shows it only once and cannot retrieve it later.

## Step 2: Connect in the platform

1. În platformă, mergeți la **Access Reviews** > **Sources** > **Add Source**. 2. Găsiți **SendGrid**, faceți clic pe **APIKey**, lipiți cheia și faceți clic pe **Conectați**.

platforma numește sursa după numele companiei din profilul contului dvs. SendGrid și atrage colegii de echipă în campaniile dvs.

## Troubleshooting

- **Key rejected.** Confirm the key has Full Access, or Custom Access including the Teammates permission. A Billing Access key reaches only billing endpoints. If you did not copy the key value when you created it, you cannot recover it, so create a new key instead.
- **No teammates appear.** The key needs at least Read Access to Teammates. A short list can also be correct: Free and Essentials accounts allow one teammate per account, while Pro and higher allow up to 1,000.
- **MFA is unknown for the account owner.** SendGrid reports two-factor state through the auto-set `2fa_exempt` and `2fa_required` scopes. A full-access user, including the owner, holds every scope and therefore both flags, so the platform reports unknown.
- **The source keeps its default name.** The name comes from the **company** field on your SendGrid account profile. the platform keeps the default name when that field is blank, and when the key cannot read the profile. To have the platform pick the name up, fill in the company field and give the key read access to the account profile, or use a Full Access key.
