> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.crehana.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.crehana.com/_mcp/server.

# Primeros pasos

Vas a necesitar dos cosas: el **slug de tu organización** y el par de
credenciales (**API key** y **secret access**) que te entrega Crehana.

El slug es el identificador de tu organización dentro de las rutas. Si tu
espacio es `https://www.crehana.com/org/acme/`, tu slug es `acme`.

## 1. Verificá que tus credenciales funcionan

La llamada más barata para probar es listar las áreas de tu organización:

```bash
curl https://www.crehana.com/api/v5/rest/org/acme/organizations/areas/ \
  -H "Api-Key: $API_KEY" \
  -H "Secret-Access: $SECRET_ACCESS"
```

Si las credenciales son correctas vas a recibir un `200` con el total y la
página de resultados:

```json
{
  "total": 12,
  "results": [
    { "id": 1, "name": "Tecnología" },
    { "id": 2, "name": "Comercial" }
  ]
}
```

Si en cambio te llega un `401`, revisá los dos headers: van siempre juntos, y
falta uno alcanza para que el request se rechace.

```json
{
  "detail": {
    "errors": ["AuthenticationError: User is not authenticated in centralized"]
  }
}
```

## 2. Traé tus usuarios

```bash
curl "https://www.crehana.com/api/v5/rest/org/acme/users/user-organizations/?limit=10" \
  -H "Api-Key: $API_KEY" \
  -H "Secret-Access: $SECRET_ACCESS"
```

> **Note**
>
> Existe también `/users/user-organizations/basic/`, que devuelve menos campos
> por usuario. Si solo necesitás identificar personas —y no su estructura
> completa— es bastante más liviano.

## 3. Elegí por dónde seguir

#### [Paginación](/documentacion/conceptos/paginacion)

Cómo recorrer listados largos. Hay dos estilos y conviene saber cuál usa
cada endpoint.

#### [Errores](/documentacion/conceptos/errores)

Qué significa cada status, y por qué no conviene programar contra el cuerpo.

#### [Sincronizar usuarios](/documentacion/casos-de-uso/sincronizar-usuarios)

El flujo completo de alta, baja y actualización desde tu sistema.

#### [Asignar contenido](/documentacion/casos-de-uso/asignar-contenido)

Del catálogo a la asignación masiva a un equipo.