Skip to main content
POST
/
clients
Create client
curl --request POST \
  --url https://api.identety.dev/clients \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "<string>",
  "type": "public",
  "redirectUris": [
    "<string>"
  ],
  "allowedScopes": [
    "<string>"
  ],
  "allowedGrants": [
    "authorization_code"
  ],
  "settings": {}
}
'
{
  "id": "uuid-123",
  "clientId": "client_abc123",
  "clientSecret": "secret_xyz789",
  "name": "My Client",
  "type": "public",
  "redirectUris": [
    "https://example.com/callback"
  ],
  "allowedScopes": [
    "openid",
    "profile"
  ],
  "allowedGrants": [
    "authorization_code"
  ],
  "isActive": true,
  "settings": {
    "tokenEndpointAuthMethod": "client_secret_basic",
    "accessTokenTTL": 3600
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.identety.dev/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
name
string
required

Client Name

​
type
enum<string>
required

Client type

Available options:
public,
private,
m2m
​
redirectUris
string[]

Redirect URIs

​
allowedScopes
string[]

Allowed Scopes

​
allowedGrants
enum<string>[]

Allowed Grants

Available options:
authorization_code,
client_credentials,
refresh_token
​
settings
object

Client Settings

Response

Client created successfully.

​
id
string
required
Example:

"uuid-123"

​
clientId
string
required
Example:

"client_abc123"

​
clientSecret
string
required
Example:

"secret_xyz789"

​
name
string
required
Example:

"My Client"

​
type
enum<string>
required
Available options:
public,
private,
m2m
​
redirectUris
string[]
required
Example:
["https://example.com/callback"]
​
allowedScopes
string[]
required
Example:
["openid", "profile"]
​
allowedGrants
string[]
required
Example:
["authorization_code"]
​
isActive
boolean
required
Example:

true

​
settings
object
required
Example:
{
  "tokenEndpointAuthMethod": "client_secret_basic",
  "accessTokenTTL": 3600
}