---
title: "Obtener Access Token M2M"
method: POST
path: "/auth/login"
tags: ["Auth"]
---

# Obtener Access Token M2M

`POST /auth/login`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/auth/login`
- Auth: API key in header `x-api-key`

Intercambia las credenciales de un cliente máquina a máquina por un Access Token.

Se usa en integraciones servidor a servidor: con el `client_id` y el `client_secret` entregados por Toku se obtiene un token de vigencia limitada, que después viaja en el header `Authorization` de cada llamada a la API, con el esquema y el token separados por un espacio (`Bearer <access_token>`).

El cuerpo acepta también el formato heredado `usuario` / `password`, que se traduce a `client_id` / `client_secret` antes de validar. Solo los clientes habilitados de forma explícita pueden usar este endpoint: cualquier otro `client_id` recibe 401, igual que unas credenciales rechazadas por el proveedor de identidad.

## Request body

- M2MLoginPayload: Credenciales de un cliente máquina a máquina con las que se solicita un Access Token. Se acepta en dos formatos: el estándar `client_id` / `client_secret`, y el heredado `usuario` / `password`, que se traduce al estándar antes de validar.
  - `client_id` string, required: Identificador del cliente entregado por Toku.
  - `client_secret` string, required: Secreto asociado al cliente. No se registra ni se devuelve.

## Response `200`

Successful Response

- M2MLoginResponse: Access Token emitido para un cliente máquina a máquina.
  - `access_token` string, required: Token que autoriza las llamadas siguientes, enviado en el header `Authorization`.
  - `expires_in` integer, required: Segundos de vigencia del token desde su emisión.
  - `token_type` string, required: Esquema con el que se envía el token en el header `Authorization`.

## Other responses

- `401`: Las credenciales no son válidas, o el `client_id` no está habilitado para este flujo.
- `422`: Validation Error

## Changes

- **2026-11-03** `a6ef070075b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/auth/login/post.md)

---

[API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)