POST
/
clients
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
  }
}

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

201
application/json
Client created successfully.
​
id
string
required
​
clientId
string
required
​
clientSecret
string
required
​
name
string
required
​
type
enum<string>
required
Available options:
public,
private,
m2m
​
redirectUris
string[]
required
​
allowedScopes
string[]
required
​
allowedGrants
string[]
required
​
isActive
boolean
required
​
settings
object
required
Client OverviewClient Details