---
title: "Connects a client"
method: POST
path: "/clients/connect"
tags: ["Clients"]
---

# Connects a client

`POST /clients/connect`

Exchanges temporary pin for full oauth client credentials

## Request body

- object
  - `pin` string, required — Previously temporarily issued PIN from the Voucher Admin UI (30 minutes validity)

## Response `200`

OK

- object
  - `id` string — Primary identification key - will be used in client calls
  - `client_group_id` string — Primary identification key from the selected group (id)
  - `name` string — Naming or description of the client
  - `secret` string — secret
  - `scopes` string[]
  - `created_at` string, RFC3339 — created_at - datetime in RFC3339 format, see https://tools.ietf.org/html/rfc3339
  - `updated_at` string, RFC3339 — updated_at - datetime in RFC3339 format, see https://tools.ietf.org/html/rfc3339
  - `connected_at` string, RFC3339 — connected_at - datetime in RFC3339 format, see https://tools.ietf.org/html/rfc3339
  - `type` string — The type of this client

## Other responses

- `401` — Invalid pin or client was already registered
- `404` — The requested resource could not be found but may be available in the future. Subsequent requests by the client are permissible.
- `422` — The request was well-formed but was unable to be followed due to semantic errors.

---

[API](https://skmtc.net/jtl-software/apis/scx-authentication-api.md) · [All operations](https://skmtc.net/jtl-software/apis/scx-authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jtl-software/scx-authentication-api/revisions/f979b1ea6951/schema)