---
title: "POST /auth"
method: POST
path: "/auth"
tags: ["Auth"]
---

# POST /auth

`POST /auth`

Request Authentication Token

## Request body

- object
  - `client_id` string, required — API Client id
  - `client_secret` string, required — API Client secret

## Response `200`

Authentication token response

- AuthenticationTokenResponse
  - `success` boolean, required
  - `data` object, required
    - `token` string, required
    - `expires_in` number
    - `scope` string

## Changes

- **2026-07-13** `ffc7718ba346` — 2 info
  - added the optional property `allOf[subschema #2]/data/expires_in` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/scope` to the response with the `200` status
- **2023-05-12** `2f90dd41871c` — 4 breaking
  - the request property `client_id` became required (media type: application/json)
  - the request property `client_id` became required (media type: application/x-www-form-urlencoded)
  - the request property `client_secret` became required (media type: application/json)
  - the request property `client_secret` became required (media type: application/x-www-form-urlencoded)
- **2023-05-12** `ff593a7d4068` — 2 info
  - api tag `Auth` added
  - added the media type `application/json` for the response with the status `200`
- **2023-05-12** `98f39d8910e1` — 2 warning, 1 info
  - deleted the `query` request parameter `client_id`
  - deleted the `query` request parameter `client_secret`
  - added optional request body
- **2017-03-18** `76b2e8a09a09` — 4 breaking, 1 info
  - added the new required `query` request parameter `client_id`
  - added the new required `query` request parameter `client_secret`
  - removed the request body
  - removed the media type `application/json` for the response with the status `200`
  - …1 more

[Change history](https://skmtc.dev/personio/apis/authentication/changes/auth/post.md)

---

[API](https://skmtc.dev/personio/apis/authentication.md) · [All operations](https://skmtc.dev/personio/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/personio/authentication/revisions/ffc7718ba346/schema)