Function postClient

POST /clients – Creates a new client application.

---

📥 Request

Headers:

• Authorization: Bearer <access_token> (required)
• Content-Type: application/json or application/x-www-form-urlencoded (required)

Body:

• See PostClientRequest

Path Parameters:

• None

Query Parameters:

• None

---

📤 Response

• 200 OK – Returns the newly created client Client.

---

❗ Errors

Status Code	Meaning	When it Happens
400	Bad Request	Missing or invalid fields in request body
401	Unauthorized	Missing or invalid authentication token
500	Internal Server Error	Unexpected error during client creation

Error Response Format

{
  "error": "Detailed error message here"
}
Copy

---

📦 Examples

📥 Auth0 Request

POST /clients
{
	"provider": "auth0-client",
	"client": {
		"product": "exampleProduct",
		"name": "New Client App",
		"callbacks": ["https://new-callback-url.com"],
		"grantTypes": ["implicit"],
		"allowedLogoutUrls": ["https://new-logout-url.com"],
		"description": "A description for the new client",
		"clientMetadata": { "key": "value" }
	}
}
Copy

📥 Cognito Request

POST /clients
{
	"provider": "cognito-client",
	"userPoolId": "us-east-1_1234test",
	"client": {
		"product": "exampleProduct",
		"name": "New Client App",
		"callbacks": ["https://new-callback-url.com"],
		"grantTypes": ["implicit"],
		"allowedLogoutUrls": ["https://new-logout-url.com"],
		"description": "A description for the new client",
		"clientMetadata": { "key": "value" }
	}
}
Copy

📤 Response Example

json
	{
		"id": "clientId",
		"name": "New Client App",
		"product": "exampleProduct",
		"callbacks": ["https://new-callback-url.com"],
		"grantTypes": ["implicit"],
		"allowedLogoutUrls": ["https://new-logout-url.com"],
		"description": "A description for the new client",
		"clientMetadata": { "key": "value" }
		// More fields may be present depending on the provider
	}
Copy

---