Create a record in Airtable when an issue is opened in Linear

What each client fills in

Airtable: Base ID

From the base’s URL: airtable.com/appXXXX/…

Airtable: Table

For example Leads

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.

• Airtable

  airtable.com/create/tokens → Create token → scopes data.records:write and data.records:read (lookups and the triggers) → add the client’s base → copy the token.

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 Airtable, for “Create a record”
3. Fill in Linear: Team ID (Webhooks can be made only with an admin’s API key)
4. Fill in Airtable: Base ID (From the base’s URL: airtable.com/appXXXX/…)
5. Fill in Airtable: Table (For example Leads)
6. Match Airtable’s fields to the client’s own: Title, Description, Identifier ENG123, Priority 0 none to 4 low