Customers

Create a customer secret

Creates a unique customer secret key valid within a scope of time.

post/customers/{customerId}/create-secret

Request

Path parameters

customerIdstring nullable required

The unique identifier of the customer.

Headers

versionstring nullable required

The API version with format yyyy-mm-dd. The current version is 2026-02-27.

Response

OK

secretstring nullable

The unique identifier for the secret.

createdAtstring date-time

The creation date, in ISO 8601 UTC format.

expireAtstring date-time

The timestamp at which the customer secret expires, in ISO 8601 UTC format.

Example response

{
  "secret": "cs_qNkU6yob0vOMxUlb2oynUw",
  "createdAt": "2022-10-31T10:15:00Z",
  "expireAt": "2022-10-31T10:30:22Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.