All docs

Linear

Updated . 2 min read.

Create a Linear issue for each accepted submission.

Availability: awaiting provider verification. The connector is built and tested against recorded responses, but it has not yet passed a live test in a Linear workspace, so it is off by default and shown as "Implemented, awaiting provider verification". Status changes in Linear are not synced back yet.

What you need

  • A Linear personal API key (or an OAuth access token) that can create issues.
  • The team ID that should receive them.

What you configure

  • API key and credential type.
  • Team ID.
  • Title field - defaults to name; falls back to the form name and submission id.
  • Priority - optional.

What Formspring sends

An issue with the title above and a description listing the answers as plain text in a code block, followed by a line naming the form and submission it came from. Answers cannot mention people or inject formatting.

Steps

  1. In Linear, create a personal API key under Settings → Security & access.
  2. Copy the team UUID.
  3. In Formspring, open your form → Integrations → Linear → fill the fields → Save.
  4. Submit a test and confirm the issue and a 2xx in Deliveries.

Tips

  • Linear can answer 200 with an error. Formspring checks the response and records a rejected issue as a failed delivery.
  • Linear has no duplicate protection. If a request times out after Linear created the issue, a retry can create a second one; the provenance line helps you spot it.

More help