---
title: "Create API Client"
method: POST
path: "/v1/clients"
tags: ["Clients"]
---

# Create API Client

`POST /v1/clients`

## Request

- Base URL: `https://api.racehooks.io`
- URL: `https://api.racehooks.io/v1/clients`
- Auth: API key in header `X-Admin-Secret`

Provision a new API client. Requires X-Admin-Secret header.

## Response `200`

Client created — store the client_secret, it will not be shown again

- object: Client created — store the client_secret, it will not be shown again
  - `data` object
    - `clientId` string
    - `clientSecret` string
    - `note` string

## Other responses

- `403`: Missing or invalid X-Admin-Secret

---

[API](https://skmtc.dev/racehooks/apis/racehooks-api.md) · [All operations](https://skmtc.dev/racehooks/apis/racehooks-api/llms.txt) · [OpenAPI document](https://skmtc.dev/racehooks/apis/racehooks-api/revisions/2335b73f46e4?raw)