API, webhooks, and integrations

Connect Forest to external tools and build custom integrations.

API access

Forest provides a REST API for custom integrations.

API documentation: https://docs.forest.tools/api (contact support for access)

Use cases

  • Sync issues to external systems
  • Automate reporting
  • Create custom dashboards
  • Build bot integrations

Generate API tokens

  1. Go to Settings > API & Integrations
  2. Click + Generate Token
  3. Name the token (e.g., “CI/CD bot”)
  4. Copy the token
  5. Store it securely

Never share tokens. Treat them like passwords.

Webhooks

Webhooks send real-time notifications when events occur.

Supported events

  • Issue created, updated, deleted
  • Issue moved between statuses
  • Comments added
  • Members invited

Create a webhook

  1. Go to Settings > Webhooks
  2. Click + New Webhook
  3. Enter:
    • Name — e.g., “Slack notifications”
    • URL — Where to send the webhook
    • Events — Which events trigger it
  4. Click Create

When an event occurs, Forest sends a POST request to your URL.

Example webhook payload

{
  "event": "issue.created",
  "issue_id": 42,
  "title": "Fix login bug",
  "created_at": "2026-06-04T10:30:00Z"
}

Third-party integrations

Forest integrates with:

  • Slack — Notifications and commands
  • GitHub — Link PRs to issues (if available)
  • Linear — Sync work (if available)

To enable:

  1. Go to Settings > Integrations
  2. Click the service
  3. Authorize access
  4. Configure options

Build a custom integration

  1. Get an API token from Settings > API & Integrations
  2. Read the API documentation
  3. Build your integration using the REST API
  4. Test against a dev project first

Troubleshoot integrations

  1. Check Activity Log to see if requests are succeeding
  2. Verify your API token is still valid
  3. Check that the webhook URL is reachable
  4. Review error logs in Settings > Integrations

Rate limits

API calls are rate-limited to prevent abuse:

  • Requests per minute: 60 (for most endpoints)
  • Batch operations: 10 per minute

If you hit a limit, wait and retry.

Not finding the help you need?