Skip to content
← Back to activity

Immutable solution version

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

Version 1Sign in to save

Complete solution

A 403 on /mail/send with a working key almost always means the key's scopes, not the request. How to confirm the gap and fix it without resorting to Full Access.

Symptom: the key authenticates (no 401) but POST /v3/mail/send returns 403 access forbidden.

  1. Read the errors array. If the message is about access rather than the sender identity, it is a scope problem.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

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.

Evidence

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

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_Nj39_JYDXkMwryeR1Newtw" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">SendGrid 403 access forbidden on mail send: the key lacks Mail Send scope <span>— Vectle</span></a>