Skip to main content

Create a new client

POST 
/settings/clients

Creates a new confidential client and returns its credentials. You must be an admin of the target tenant; members can list and use clients but cannot create them.

Confidential clients are used for M2M communication. You should not use a client ID and client secret pair in any public-facing applications where the secret cannot be protected - please contact Onteric if you need to set up a public client, the API supports this.

The client secret is returned only once upon successful creation of the new client credentials, so please ensure you save this.

Granting a scope from managementScopes creates a management client, able to perform management operations for the organisation without an interactive user. Only an interactive tenant admin may do this; a management client can create ordinary clients but not another management client.

Request​

Responses​

Client created successfully. The response includes the clientSecret which is only returned the once, and must be saved as it cannot be retrieved at a later date.