Create a service token

POST /accounts/{account_id}/access/service_tokens

Copy endpoint

https://api.cloudflare.com/client/v4

Generates a new service token. Note: This is the only time you can get the Client Secret. If you lose the Client Secret, you will have to rotate the Client Secret or create a new service token.

Parameters

path Path Parameters

Name	Type
`account_id` required	type AccessIdentifier = string

Request Body

application/json required

{ duration?:

AccessDuration

The duration for how long the service token will be valid. Must be in the format 300ms or 2h45m. Valid time units are: ns, us (or µs), ms, s, m, h. The default is 1 year in hours (8760h).

type AccessDuration = string

;name:

AccessSchemasName

The name of the service token.

type AccessSchemasName = string

; }

Responses

201 application/json

Create a service token response

type AccessCreateResponse = never

Client Errors

4XX application/json

Create a service token response failure

interface AccessApiResponseCommonFailure {
errors:

AccessMessages

type AccessMessages = {
code: number;
documentation_url?: string;
message: string;
source?: { pointer?: string; };
}[]

;
messages:

AccessMessages

type AccessMessages = {
code: number;
documentation_url?: string;
message: string;
source?: { pointer?: string; };
}[]

;
result: null;
success: false;
}