Send an email in SendGrid when an issue is opened in Linear

What each client fills in

SendGrid: From address

For example hello@northside.example

Who it goes to (SendGrid)

The address that gets it: yours, or the client’s team.

Linear: Team ID

Webhooks can be made only with an admin’s API key.

The accounts it needs

Each is the client’s own, stored encrypted and never copied between clients. Until one is added the client’s checklist shows it, and nothing runs.

• 

  In the client’s Linear: Settings → Security & access → Personal API keys → New API key. The triggers make webhooks, which needs a workspace admin’s key.

• 

  SendGrid → Settings → API Keys → Create API Key with Mail Send access; for the triggers, also the Event Webhook settings permission (user.webhooks.event.settings.read and user.webhooks.event.settings.update), or Full Access. The From address must be a verified sender.

After you install it

It lands switched off. The client’s checklist holds exactly this:

1. Connect the client’s Linear, for “An issue is opened”
2. Connect the client’s SendGrid, for “Send an email”
3. Fill in Linear: Team ID (Webhooks can be made only with an admin’s API key)
4. Fill in SendGrid: From address (For example hello@northside.example)
5. Fill in Who it goes to (SendGrid) (The address that gets it: yours, or the client’s team)