The POST /environments/{{envID}}/users/{{userID}}/linkedAccounts
operation creates a linked account to an external identity provider for the user resource with the ID specified in the request URL.
This operation uses the application/vnd.pingidentity.account.link+json
custom content type in the request header, and it must specify the identityProvider.Id
and the externalId
for the user account in the request body. The request body can also specify an optional list of user attributes to update during the account linking action.
See Users for important overview information.
Create a user to get a userID
and username
. See Create User. Run Read User or Users to find an existing user.
See Identity Providers for more information about adding an identity provider for the idpID
value. Run Read All Identity Providers to find an existing IdP.
Property | Type | Required? |
---|---|---|
identityProvider.id |
String | Required |
externalId |
String | Required |
See the Linked Accounts data model for full property descriptions.