> ## Documentation Index
> Fetch the complete documentation index at: https://docs.forecastable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Create an integration API key and make your first authenticated request to the Forecastable Integration API.

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

<Steps>
  <Step title="Create an integration API key">
    In Forecastable, open [Settings → API keys](https://app.forecastable.com/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.
  </Step>

  <Step title="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.

    ```bash theme={null}
    curl -s https://app.forecastable.com/api/v1/meta | jq
    ```
  </Step>

  <Step title="List accessible organizations">
    Send your token as a Bearer credential:

    ```bash theme={null}
    curl -s https://app.forecastable.com/api/v1/organizations \
      -H "Authorization: Bearer YOUR_INTEGRATION_TOKEN" | jq
    ```

    Pick an organization `id` from the response. You will use it in the next step.
  </Step>

  <Step title="Fetch accounts for an organization">
    Most endpoints require organization context. Pass `X-Organization-Id` on the request:

    ```bash theme={null}
    curl -s "https://app.forecastable.com/api/v1/accounts" \
      -H "Authorization: Bearer YOUR_INTEGRATION_TOKEN" \
      -H "X-Organization-Id: YOUR_ORGANIZATION_ID" | jq
    ```

    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`.
  </Step>
</Steps>

## Next steps

<Card title="Explore the API reference" icon="book" href="/api-reference/meta/get-integration-api-metadata">
  See every endpoint, required scope, and request body schema.
</Card>

<Card title="API keys" icon="key" href="/developers/api-keys">
  Learn how to create and manage integration API keys.
</Card>

<Card title="Connect an MCP client" icon="https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp.png?fit=max&auto=format&n=fU69crspsqRT-kfC&q=85&s=ecb2d15b0f6d90ada43faa0eb38b8746" href="/developers/mcp" width="32" height="32" data-path="images/mcp.png">
  Expose the same API as MCP tools for Cursor, Claude Desktop, and other agents.
</Card>

<Tip>
  Questions or blocked on auth? Email [support@forecastable.com](mailto:support@forecastable.com). Include the `X-Request-Id` response header when reporting failed API calls.
</Tip>