Create a User

POST/v1/users

Create a user.

USER_CREATE_START
USER_CREATE_SUCCESS
USER_CREATE_FAIL

Roles

adminissuermanaged-issuer

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

Create a User

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl -X POST "https://example.com/v1/users" \  -H "Content-Type: application/json" \  -d '{}'

{  "id": "0c3fad74-a8df-4a2d-8e75-f2d356b413ba",  "claims": {    "externalUserId": "0c3fad74-a8df-4a2d-8e75-f2d356b413ba"  },  "authenticationProvider": {    "providerId": "41458e5a-9092-40b7-9a26-d4eb43c5792f",    "url": "https://example-university.au.auth0.com",    "subjectId": "example-university-oauth2|123456789"  }}

POST/v1/users

Create a user.

USER_CREATE_START
USER_CREATE_SUCCESS
USER_CREATE_FAIL

Roles

adminissuermanaged-issuer

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

Create a User

TypeScript Definitions

Use the request body type in TypeScript.

claims?

User claims to be persisted. No claims are persisted by default. Consider PII implications before persisting any claims.

authenticationProvider?

Authentication Provider information for the user. This enables linking the user to an external identity provider. If implemented insecurely, this process can be exploited by malicious actors to gain unauthorized access to legitimate user accounts.

To mitigate this risk, require authentication for both accounts involved in the link, whether the link is created manually or automatically. Always prompt the user to enter credentials to verify ownership before establishing the link.

Response Body

`application/json`

curl -X POST "https://example.com/v1/users" \  -H "Content-Type: application/json" \  -d '{}'

{  "id": "0c3fad74-a8df-4a2d-8e75-f2d356b413ba",  "claims": {    "externalUserId": "0c3fad74-a8df-4a2d-8e75-f2d356b413ba"  },  "authenticationProvider": {    "providerId": "41458e5a-9092-40b7-9a26-d4eb43c5792f",    "url": "https://example-university.au.auth0.com",    "subjectId": "example-university-oauth2|123456789"  }}

Roles

Authorization

Request Body

Response Body

201application/json

400application/json

Create a User

Roles

Authorization

Request Body

Response Body

201application/json

400application/json

`application/json`

`application/json`

`application/json`

`application/json`