> ## 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.

# Inicio rápido

> Autentícate y haz tu primera llamada a la API de iZap.

Esta guía te lleva de cero a tu primera llamada autenticada a la API.
Necesitas una cuenta de iZap en el entorno que vas a usar (producción o
staging).

## Paso 1: obtén un token de acceso

La API autentica cada solicitud con un JWT Bearer. Para empezar rápido,
intercambia las credenciales de tu cuenta por un token en el endpoint de login:

```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>
  Para aplicaciones de terceros, usa el flujo OAuth 2.0 authorization code + PKCE
  en lugar de guardar credenciales. Consulta
  [Autenticación](/es/api-reference/authentication).
</Note>

## Paso 2: llama a la API

Envía el token como encabezado Bearer en cada solicitud:

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

Los tokens expiran: renuévalos (con un nuevo login o con el grant de refresh de
OAuth) cuando una solicitud devuelva `401`.

## Paso 3: conecta el Analytics MCP (opcional)

¿Prefieres controlar iZap desde un cliente o agente de IA? Apúntalo al servidor
MCP de iZap y llama a sus herramientas directamente:

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

Consulta [Analytics MCP](/es/api-reference/mcp) para ver el catálogo completo de
herramientas.

<Tip>
  ¿Quieres que la estructura se genere por ti? `npx @izap/wizard` escribe un
  cliente REST, MCP, de webhooks o SSE funcional en tu proyecto. Consulta el
  [asistente de configuración](/es/api-reference/wizard).
</Tip>

## Próximos pasos

<Columns cols={2}>
  <Card title="Autenticación" icon="key" href="/es/api-reference/authentication">
    Flujo OAuth 2.0, discovery y uso de JWT.
  </Card>

  <Card title="API REST" icon="code" href="/es/api-reference/introduction">
    Los recursos que expone iZap y cómo llamarlos.
  </Card>
</Columns>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.