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

# Quickstart

> Integra Lumos CRM en tres pasos

## Integra en tres pasos

Esta guia resume el camino mas corto para conectar un sistema externo con Lumos CRM.

### Paso 1: configura acceso

1. Ingresa con un usuario de rol admin del tenant.
2. Genera, recupera o rota la API key del tenant desde la consola de administracion.
3. Guarda la API key en tu gestor seguro de secretos.
4. Identifica el `tenantId` que usaras en todas las llamadas de integracion.

<Note>
  Solo el perfil admin puede gestionar la API key de integraciones desde la consola de administracion.
</Note>

### Paso 2: ejecuta la primera llamada

```bash theme={null}
curl --request GET \
  --url "https://lumos-am-prd.azure-api.net/api/external/integrations/v1/accounts?tenantId=<tu_tenant_id>" \
  --header "x-api-key: <tu_api_key_de_integraciones>" \
  --header "Content-Type: application/json"
```

Si recibes codigo 401, revisa que la API key corresponda al mismo tenantId.

### Paso 3: habilita endpoints de soporte

Activa los endpoints de soporte para tus flujos operativos:

1. Cuando cambie tu politica de seguridad, rota la API key desde la consola de administracion.
2. Usa resumen de oportunidades e hilos para contexto comercial.
3. Resuelve grantId cuando necesites trazabilidad entre sistemas.

## Siguiente paso

<CardGroup cols={2}>
  <Card title="Revisa autenticacion" icon="shield" href="/api-reference/introduction">
    Valida el flujo admin para API key y el uso obligatorio de tenantId.
  </Card>

  <Card title="Explora endpoints" icon="terminal" href="/api-reference/endpoint/accounts-list">
    Implementa operaciones de lectura y escritura para tus casos de negocio.
  </Card>
</CardGroup>