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

# Quickstart

> Authenticate and make your first call to the iZap API.

This guide gets you from zero to your first authenticated API call. You'll need
an iZap account on the environment you're targeting (production or staging).

## Step 1: Get an access token

The API authenticates every request with a Bearer JWT. For a quick start, exchange
your account credentials for a token at the login endpoint:

```bash theme={null}
curl -X POST "https://api.izap.ai/api/v1/auth/jwt/login" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "username=$IZAP_EMAIL&password=$IZAP_PASSWORD"
# -> {"access_token":"<JWT>","token_type":"bearer"}
```

<Note>
  For third-party apps, use the OAuth 2.0 authorization-code + PKCE flow instead of
  storing credentials. See [Authentication](/en/api-reference/authentication).
</Note>

## Step 2: Call the API

Send the token as a Bearer header on every request:

```bash theme={null}
export IZAP_TOKEN="<JWT>"
curl "https://api.izap.ai/api/v1/businesses" \
     -H "Authorization: Bearer $IZAP_TOKEN"
```

Tokens expire — refresh them (re-login or the OAuth refresh grant) when a request
returns `401`.

## Step 3: Connect the Analytics MCP (optional)

Prefer to drive iZap from an AI client or agent? Point it at the iZap Analytics
MCP server and call its tools directly:

```json theme={null}
{
  "mcpServers": {
    "izap": {
      "type": "http",
      "url": "https://api.izap.ai/mcp",
      "headers": { "Authorization": "Bearer ${IZAP_TOKEN}" }
    }
  }
}
```

See [Analytics MCP](/en/api-reference/mcp) for the full tool catalog.

<Tip>
  Want the scaffolding done for you? `npx @izap/wizard` writes a working REST,
  MCP, webhook, or SSE client into your project. See the
  [setup wizard](/en/api-reference/wizard).
</Tip>

## Next steps

<Columns cols={2}>
  <Card title="Authentication" icon="key" href="/en/api-reference/authentication">
    OAuth 2.0 flow, discovery, and JWT usage.
  </Card>

  <Card title="REST API" icon="code" href="/en/api-reference/introduction">
    The resources iZap exposes and how to call them.
  </Card>
</Columns>