Add a database row in Notion when an issue changes status in Linear

What each client fills in

Notion: Database ID

For example the 32 characters in the database URL

Notion: Title column

For example Name

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.

• 

  notion.so/profile/integrations → New integration (Internal) in the client’s workspace → Capabilities: Read content, Insert content and Update content (the row update needs the last) → copy the secret. Then open the database → ••• → Connections → add the integration.

After you install it

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

1. Connect the client’s Linear, for “An issue changes status”
2. Connect the client’s Notion, for “Add a database row”
3. Fill in Linear: Team ID (Webhooks can be made only with an admin’s API key)
4. Fill in Notion: Database ID (For example the 32 characters in the database URL)
5. Fill in Notion: Title column (For example Name)