Skip to main content
This guide takes you from zero to a working Integration API call. You will create a token, read public API metadata, list the organizations your token can access, and fetch accounts for one organization.

​
Prerequisites

Before you begin, make sure you have:
  • a Forecastable account with permission to create integration API keys
  • access to at least one organization in Forecastable
  • curl or another HTTP client (Postman and similar tools also work)

​
Get started

1

Create an integration API key

In Forecastable, open Settings → API keys.Create a key with the scopes you need. For this walkthrough, include at least:
  • organizations:read
  • accounts:read
Restrict the key to specific organizations if you want least-privilege access. Copy the token when it is shown — Forecastable does not display the full secret again.
2

Read API metadata

GET /meta is public and does not require authentication. Use it to confirm base URLs, supported scopes, pagination defaults, and rate limits.
3

List accessible organizations

Send your token as a Bearer credential:
Pick an organization id from the response. You will use it in the next step.
4

Fetch accounts for an organization

Most endpoints require organization context. Pass X-Organization-Id on the request:
If your token is scoped to a single organization, Forecastable may infer the organization automatically. When multiple identifiers conflict, the API returns ambiguous_subscriber_context.

​
Next steps

Explore the API reference

See every endpoint, required scope, and request body schema.

API keys

Learn how to create and manage integration API keys.

Connect an MCP client

Expose the same API as MCP tools for Cursor, Claude Desktop, and other agents.
Questions or blocked on auth? Email support@forecastable.com. Include the X-Request-Id response header when reporting failed API calls.