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

# Empezar aquí

> Tu primera llamada autenticada a la API de cuenta de Yampi.

Sales de esta página con tres cosas: la base URL, un token de usuario y un `account_id` con el que puedas llamar un recurso real. Si aún no tienes claro el producto, lee antes [Qué es Yampi](/guides/que-es-yampi).

## Base URL

```bash theme={null}
https://app.yampi.ai
```

La API de cuenta vive bajo `/api/v1/`. Casi todo lo de una inmobiliaria cuelga de:

```text theme={null}
/api/v1/accounts/{account_id}/...
```

## Autenticación

Envía el token en el header `api_access_token`:

```bash theme={null}
curl https://app.yampi.ai/api/v1/profile \
  -H "api_access_token: TU_TOKEN"
```

Si el header está presente, Yampi autentica con ese token. Si no, usa la sesión de la app.

### De dónde sale el token

Cada usuario tiene un `AccessToken`. En `GET /api/v1/profile` el campo `access_token` trae el valor actual; ahí también ves las cuentas (`accounts`) con `id`, `role` y `suite_role`.

Para regenerarlo:

```bash theme={null}
curl -X POST https://app.yampi.ai/api/v1/profile/reset_access_token \
  -H "api_access_token: TU_TOKEN"
```

La respuesta es de nuevo el perfil, con el token nuevo.

## Primera llamada

<Steps>
  <Step title="Obtén el perfil">
    Llama `GET /api/v1/profile` con tu token y guarda un `accounts[].id`.
  </Step>

  <Step title="Elige la cuenta">
    Ese `id` es tu `account_id`. Casi todas las rutas de producto lo llevan en el path.
  </Step>

  <Step title="Lista un recurso">
    Por ejemplo, las propiedades de la cuenta `42`:

    ```bash theme={null}
    curl "https://app.yampi.ai/api/v1/accounts/42/properties" \
      -H "api_access_token: TU_TOKEN"
    ```
  </Step>
</Steps>

Si ves `401` / Invalid Access Token, el header no llegó o el token no existe.

## Siguiente paso

* [Conceptos](/guides/conceptos) — cuenta, suites y el mapa del dominio.
* Pestaña **API** — contrato HTTP por endpoint.
* Pestaña **MCP** — lectura con OAuth Bearer (el conector MCP no usa `api_access_token`).