---
title: "Create a new client ID"
method: POST
path: "/v2/client-ids"
tags: ["Client IDs", "V2/Client IDs"]
---

# Create a new client ID

`POST /v2/client-ids`

Create a new client ID for frontend applications with domain restrictions

## Headers

- `x-api-key` string, required

## Request body

- object
  - `label` string, required
  - `allowedDomains` string[], required — List of allowed domain origins (normalized)
  - `feePercentage` string — Fee percentage (e.g., '1' = 1%, '2.5' = 2.5%, '2.55' = 2.55%). Maximum 2 decimal places. If set to '0', allows API request fees to take precedence. If set to any other value, overrides any fee passed via API.
  - `feeAddress` string — Wallet address to receive fees. Required if feePercentage is set.
  - `operatorWalletAddress` string — Wallet address that will act as operator for commerce payments. The API operator wallet will execute transactions on behalf of this address. Can be a smart wallet that has granted permissions to the API operator.
  - `defaultPreApprovalExpiry` integer — Default pre-approval expiry duration in seconds for commerce transactions. If set, overrides the value passed in /v2/commerce-payments/authorize/calldata endpoint.
  - `defaultAuthorizationExpiry` integer — Default authorization expiry duration in seconds for commerce transactions. If set, overrides the value passed in /v2/commerce-payments/authorize/calldata endpoint.

## Response `201`

Client ID created successfully

- object
  - `id` string
  - `clientId` string
  - `label` string
  - `allowedDomains` string[]
  - `feePercentage` string, nullable
  - `feeAddress` string, nullable
  - `operatorWalletAddress` string, nullable
  - `defaultPreApprovalExpiry` number, nullable
  - `defaultAuthorizationExpiry` number, nullable
  - `status` string
  - `createdAt` string

## Other responses

- `400` — Bad request - validation failed
- `401` — Unauthorized
- `429` — Too Many Requests

---

[API](https://skmtc.dev/request/apis/request-network-api.md) · [All operations](https://skmtc.dev/request/apis/request-network-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/request/request-network-api/revisions/042a895ac0c6/schema)