Trigger Modes

Configure how SpecSource detects new issues to process.

SpecSource supports two trigger modes for automatically detecting and processing new issues: polling and webhook.

Polling (default)

Polling periodically checks your connected issue trackers (Linear, Asana) for new issues. This is the default mode and works reliably with all plan tiers.

Setting up polling

  1. Go to your project's Agent Runs page
  2. Click the settings icon next to the trigger status
  3. Set mode to Polling
  4. Choose an interval: 1, 2, 5 (default), 10, 15, or 30 minutes
  5. Click Save

How it works

Each poll fetches recent issues from your connected trackers and compares them against previously processed issues. New issues are queued for spec sourcing automatically. Duplicate issues are skipped.

Webhook

Webhook mode receives real-time notifications from your issue tracker when new issues are created. This provides faster response times but requires additional permissions.

Setting up webhooks

  1. Go to your project's Agent Runs page
  2. Click the settings icon next to the trigger status
  3. Set mode to Webhook
  4. Click Save

SpecSource will automatically register webhooks with your connected trackers. For Linear, this requires workspace admin permissions (the OAuth flow requests the admin scope solely for webhook registration).

When to use webhooks

  • You need near-instant spec sourcing (seconds vs minutes)
  • Your Linear workspace supports webhook delivery
  • You have admin access to authorize the webhook scope

Switching modes

You can switch between polling and webhook at any time. When switching:

  • To polling: Any registered webhooks are automatically removed. A polling schedule starts immediately.
  • To webhook: The polling schedule is stopped. Webhooks are registered with your connected trackers.

Switching modes does not affect previously processed issues — SpecSource tracks which issues have been processed to avoid duplicates regardless of mode.

Credits

Both modes consume credits when processing issues. If your credits are exhausted, detected issues will not be processed until credits are available.