Nexus
Nexus APIs
POST
/v1/users/{userId}/custom-upns
Creates a custom UPN for a user.
Custom UPNs allows users to have multiple UPNs associated with their account for logins to AD-backed and RDP hosted applications, where the UPN in Active Directory does not match the standard UPN format.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
userId |
path | Yes | — |
Request body
Request payload
Example
{
"clientUpnKey": "string",
"customUpnValue": "string"
}Schema
| Name | Type | Attributes | Description | Extensions |
|---|---|---|---|---|
clientUpnKey
|
string
|
nullable |
This value is used to associated a particular custom UPN with a specific Auth0 client.
The Auth0 client must specify the custom metadata property `app_upn_key` in order to link
use this custom UPN as the `upn` claim in the resulting ID Token.
maxLength: 255
|
— |
customUpnValue
|
string
|
nullable |
The custom UPN value. Must take the form of `user_part@domain_part`.
maxLength: 1024
|
— |
Example
{
"clientUpnKey": "string",
"customUpnValue": "string"
}Schema
| Name | Type | Attributes | Description | Extensions |
|---|---|---|---|---|
clientUpnKey
|
string
|
nullable |
This value is used to associated a particular custom UPN with a specific Auth0 client.
The Auth0 client must specify the custom metadata property `app_upn_key` in order to link
use this custom UPN as the `upn` claim in the resulting ID Token.
maxLength: 255
|
— |
customUpnValue
|
string
|
nullable |
The custom UPN value. Must take the form of `user_part@domain_part`.
maxLength: 1024
|
— |
Example
{
"clientUpnKey": "string",
"customUpnValue": "string"
}Schema
| Name | Type | Attributes | Description | Extensions |
|---|---|---|---|---|
clientUpnKey
|
string
|
nullable |
This value is used to associated a particular custom UPN with a specific Auth0 client.
The Auth0 client must specify the custom metadata property `app_upn_key` in order to link
use this custom UPN as the `upn` claim in the resulting ID Token.
maxLength: 255
|
— |
customUpnValue
|
string
|
nullable |
The custom UPN value. Must take the form of `user_part@domain_part`.
maxLength: 1024
|
— |
Example
{
"clientUpnKey": "string",
"customUpnValue": "string"
}Schema
| Name | Type | Attributes | Description | Extensions |
|---|---|---|---|---|
clientUpnKey
|
string
|
nullable |
This value is used to associated a particular custom UPN with a specific Auth0 client.
The Auth0 client must specify the custom metadata property `app_upn_key` in order to link
use this custom UPN as the `upn` claim in the resulting ID Token.
maxLength: 255
|
— |
customUpnValue
|
string
|
nullable |
The custom UPN value. Must take the form of `user_part@domain_part`.
maxLength: 1024
|
— |
Example
{
"clientUpnKey": "string",
"customUpnValue": "string"
}Schema
| Name | Type | Attributes | Description | Extensions |
|---|---|---|---|---|
clientUpnKey
|
string
|
nullable |
This value is used to associated a particular custom UPN with a specific Auth0 client.
The Auth0 client must specify the custom metadata property `app_upn_key` in order to link
use this custom UPN as the `upn` claim in the resulting ID Token.
maxLength: 255
|
— |
customUpnValue
|
string
|
nullable |
The custom UPN value. Must take the form of `user_part@domain_part`.
maxLength: 1024
|
— |
Example
{
"clientUpnKey": "string",
"customUpnValue": "string"
}Schema
| Name | Type | Attributes | Description | Extensions |
|---|---|---|---|---|
clientUpnKey
|
string
|
nullable |
This value is used to associated a particular custom UPN with a specific Auth0 client.
The Auth0 client must specify the custom metadata property `app_upn_key` in order to link
use this custom UPN as the `upn` claim in the resulting ID Token.
maxLength: 255
|
— |
customUpnValue
|
string
|
nullable |
The custom UPN value. Must take the form of `user_part@domain_part`.
maxLength: 1024
|
— |
Example
{
"clientUpnKey": "string",
"customUpnValue": "string"
}Schema
| Name | Type | Attributes | Description | Extensions |
|---|---|---|---|---|
clientUpnKey
|
string
|
nullable |
This value is used to associated a particular custom UPN with a specific Auth0 client.
The Auth0 client must specify the custom metadata property `app_upn_key` in order to link
use this custom UPN as the `upn` claim in the resulting ID Token.
maxLength: 255
|
— |
customUpnValue
|
string
|
nullable |
The custom UPN value. Must take the form of `user_part@domain_part`.
maxLength: 1024
|
— |
Example
{
"clientUpnKey": "string",
"customUpnValue": "string"
}Schema
| Name | Type | Attributes | Description | Extensions |
|---|---|---|---|---|
clientUpnKey
|
string
|
nullable |
This value is used to associated a particular custom UPN with a specific Auth0 client.
The Auth0 client must specify the custom metadata property `app_upn_key` in order to link
use this custom UPN as the `upn` claim in the resulting ID Token.
maxLength: 255
|
— |
customUpnValue
|
string
|
nullable |
The custom UPN value. Must take the form of `user_part@domain_part`.
maxLength: 1024
|
— |
Responses
201
Example
{
"id": "string",
"userId": "string",
"created": "string",
"modified": "string",
"createdBy": "string",
"modifiedBy": "string",
"clientUpnKey": "string",
"customUpnValue": "string"
}Schema
| Name | Type | Attributes | Description | Extensions |
|---|---|---|---|---|
clientUpnKey
|
string
|
nullable |
This value is used to associated a particular custom UPN with a specific Auth0 client.
The Auth0 client must specify the custom metadata property `app_upn_key` in order to link
use this custom UPN as the `upn` claim in the resulting ID Token.
maxLength: 255
|
— |
created
|
string (date-time)
|
nullable | The date and time the custom UPN was created. | — |
createdBy
|
string
|
nullable | The user that created the custom UPN. | — |
customUpnValue
|
string
|
nullable |
The custom UPN value. Must take the form of `user_part@domain_part`.
maxLength: 1024
|
— |
id
|
string
|
nullable | The unique ID of the custom UPN. | — |
modified
|
string (date-time)
|
nullable | The date and time the custom UPN was last modified. | — |
modifiedBy
|
string
|
nullable | The user that last modified the custom UPN. | — |
userId
|
string
|
nullable | The user ID associated with the custom UPN. | — |
Example
{
"id": "string",
"userId": "string",
"created": "string",
"modified": "string",
"createdBy": "string",
"modifiedBy": "string",
"clientUpnKey": "string",
"customUpnValue": "string"
}Schema
| Name | Type | Attributes | Description | Extensions |
|---|---|---|---|---|
clientUpnKey
|
string
|
nullable |
This value is used to associated a particular custom UPN with a specific Auth0 client.
The Auth0 client must specify the custom metadata property `app_upn_key` in order to link
use this custom UPN as the `upn` claim in the resulting ID Token.
maxLength: 255
|
— |
created
|
string (date-time)
|
nullable | The date and time the custom UPN was created. | — |
createdBy
|
string
|
nullable | The user that created the custom UPN. | — |
customUpnValue
|
string
|
nullable |
The custom UPN value. Must take the form of `user_part@domain_part`.
maxLength: 1024
|
— |
id
|
string
|
nullable | The unique ID of the custom UPN. | — |
modified
|
string (date-time)
|
nullable | The date and time the custom UPN was last modified. | — |
modifiedBy
|
string
|
nullable | The user that last modified the custom UPN. | — |
userId
|
string
|
nullable | The user ID associated with the custom UPN. | — |
Example
{
"id": "string",
"userId": "string",
"created": "string",
"modified": "string",
"createdBy": "string",
"modifiedBy": "string",
"clientUpnKey": "string",
"customUpnValue": "string"
}Schema
| Name | Type | Attributes | Description | Extensions |
|---|---|---|---|---|
clientUpnKey
|
string
|
nullable |
This value is used to associated a particular custom UPN with a specific Auth0 client.
The Auth0 client must specify the custom metadata property `app_upn_key` in order to link
use this custom UPN as the `upn` claim in the resulting ID Token.
maxLength: 255
|
— |
created
|
string (date-time)
|
nullable | The date and time the custom UPN was created. | — |
createdBy
|
string
|
nullable | The user that created the custom UPN. | — |
customUpnValue
|
string
|
nullable |
The custom UPN value. Must take the form of `user_part@domain_part`.
maxLength: 1024
|
— |
id
|
string
|
nullable | The unique ID of the custom UPN. | — |
modified
|
string (date-time)
|
nullable | The date and time the custom UPN was last modified. | — |
modifiedBy
|
string
|
nullable | The user that last modified the custom UPN. | — |
userId
|
string
|
nullable | The user ID associated with the custom UPN. | — |
Example
{
"id": "string",
"userId": "string",
"created": "string",
"modified": "string",
"createdBy": "string",
"modifiedBy": "string",
"clientUpnKey": "string",
"customUpnValue": "string"
}Schema
| Name | Type | Attributes | Description | Extensions |
|---|---|---|---|---|
clientUpnKey
|
string
|
nullable |
This value is used to associated a particular custom UPN with a specific Auth0 client.
The Auth0 client must specify the custom metadata property `app_upn_key` in order to link
use this custom UPN as the `upn` claim in the resulting ID Token.
maxLength: 255
|
— |
created
|
string (date-time)
|
nullable | The date and time the custom UPN was created. | — |
createdBy
|
string
|
nullable | The user that created the custom UPN. | — |
customUpnValue
|
string
|
nullable |
The custom UPN value. Must take the form of `user_part@domain_part`.
maxLength: 1024
|
— |
id
|
string
|
nullable | The unique ID of the custom UPN. | — |
modified
|
string (date-time)
|
nullable | The date and time the custom UPN was last modified. | — |
modifiedBy
|
string
|
nullable | The user that last modified the custom UPN. | — |
userId
|
string
|
nullable | The user ID associated with the custom UPN. | — |
Example
{
"id": "string",
"userId": "string",
"created": "string",
"modified": "string",
"createdBy": "string",
"modifiedBy": "string",
"clientUpnKey": "string",
"customUpnValue": "string"
}Schema
| Name | Type | Attributes | Description | Extensions |
|---|---|---|---|---|
clientUpnKey
|
string
|
nullable |
This value is used to associated a particular custom UPN with a specific Auth0 client.
The Auth0 client must specify the custom metadata property `app_upn_key` in order to link
use this custom UPN as the `upn` claim in the resulting ID Token.
maxLength: 255
|
— |
created
|
string (date-time)
|
nullable | The date and time the custom UPN was created. | — |
createdBy
|
string
|
nullable | The user that created the custom UPN. | — |
customUpnValue
|
string
|
nullable |
The custom UPN value. Must take the form of `user_part@domain_part`.
maxLength: 1024
|
— |
id
|
string
|
nullable | The unique ID of the custom UPN. | — |
modified
|
string (date-time)
|
nullable | The date and time the custom UPN was last modified. | — |
modifiedBy
|
string
|
nullable | The user that last modified the custom UPN. | — |
userId
|
string
|
nullable | The user ID associated with the custom UPN. | — |
Example
{
"id": "string",
"userId": "string",
"created": "string",
"modified": "string",
"createdBy": "string",
"modifiedBy": "string",
"clientUpnKey": "string",
"customUpnValue": "string"
}Schema
| Name | Type | Attributes | Description | Extensions |
|---|---|---|---|---|
clientUpnKey
|
string
|
nullable |
This value is used to associated a particular custom UPN with a specific Auth0 client.
The Auth0 client must specify the custom metadata property `app_upn_key` in order to link
use this custom UPN as the `upn` claim in the resulting ID Token.
maxLength: 255
|
— |
created
|
string (date-time)
|
nullable | The date and time the custom UPN was created. | — |
createdBy
|
string
|
nullable | The user that created the custom UPN. | — |
customUpnValue
|
string
|
nullable |
The custom UPN value. Must take the form of `user_part@domain_part`.
maxLength: 1024
|
— |
id
|
string
|
nullable | The unique ID of the custom UPN. | — |
modified
|
string (date-time)
|
nullable | The date and time the custom UPN was last modified. | — |
modifiedBy
|
string
|
nullable | The user that last modified the custom UPN. | — |
userId
|
string
|
nullable | The user ID associated with the custom UPN. | — |
Example
{
"id": "string",
"userId": "string",
"created": "string",
"modified": "string",
"createdBy": "string",
"modifiedBy": "string",
"clientUpnKey": "string",
"customUpnValue": "string"
}Schema
| Name | Type | Attributes | Description | Extensions |
|---|---|---|---|---|
clientUpnKey
|
string
|
nullable |
This value is used to associated a particular custom UPN with a specific Auth0 client.
The Auth0 client must specify the custom metadata property `app_upn_key` in order to link
use this custom UPN as the `upn` claim in the resulting ID Token.
maxLength: 255
|
— |
created
|
string (date-time)
|
nullable | The date and time the custom UPN was created. | — |
createdBy
|
string
|
nullable | The user that created the custom UPN. | — |
customUpnValue
|
string
|
nullable |
The custom UPN value. Must take the form of `user_part@domain_part`.
maxLength: 1024
|
— |
id
|
string
|
nullable | The unique ID of the custom UPN. | — |
modified
|
string (date-time)
|
nullable | The date and time the custom UPN was last modified. | — |
modifiedBy
|
string
|
nullable | The user that last modified the custom UPN. | — |
userId
|
string
|
nullable | The user ID associated with the custom UPN. | — |
Security
Authentication is required for this operation.
Source: default
Requirements (any one option may satisfy)
- Bearer and ApplicationToken
- Basic