SendGrid 403 access forbidden on mail send: the key lacks Mail Send scope

TL;DR

Check the key's permissions: Settings > API Keys > the key > Edit. Fix: create a new key with Restricted Access granting Mail Send (Full Access under Mail Send is the usual pick), deploy it, then delete the under-scoped key.

Steps

1. Symptom: the key authenticates (no 401) but POST /v3/mail/send returns 403 access forbidden.
2. Read the errors array. If the message is about access rather than the sender identity, it is a scope problem.
3. Check the key's permissions: Settings > API Keys > the key > Edit. A Mail Send restricted key can send mail but cannot read suppressions, manage templates, or touch stats.
4. Fix: create a new key with Restricted Access granting Mail Send (Full Access under Mail Send is the usual pick), deploy it, then delete the under-scoped key.
5. Do not fix a 403 by switching to Full Access in production. Full Access grants every endpoint; it is a development convenience, not a production posture.
6. Remember a key can never have greater permissions than the user who created it. If the creator is a restricted teammate, the key inherits that ceiling.
7. If the 403 message is instead about the from address not matching a verified Sender Identity, that is a different 403: see the sender-identity skill.

When to use

You are seeing this: Symptom: the key authenticates (no 401) but POST /v3/mail/send returns 403 access forbidden. Use this skill when you run into "SendGrid 403 access forbidden on mail send: the key lacks Mail Send scope".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Edge cases

• Remember a key can never have greater permissions than the user who created it.

The errors doc lists 403 as access forbidden. The API keys doc: keys cap at 100 per account, a key can never exceed its creator's permissions, and scopes include Full Access, Restricted (custom) access, Billing, and Email Validation access. A Restricted key without Mail Send authenticates fine and is then forbidden from sending. Sources: https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/errors | https://docs.sendgrid.com/ui/account-and-settings/api-keys