Link a social identity to a user account

post https://{hostname}/oauth/link_account_native

Links a new social identity to an existing user account. After a provider is linked, you can use that social identity provider to log into your Identity Cloud account.

Recipes

Link a social login identity provider

Open Recipe

Form Data

access_token

string

Access token returned following authentication or registration.

client_id

string

Unique identifier of the API client that authenticated the operation. This client must be configured with the login_client feature, which gives it permission to use login and registration-based API endpoints.

flow

string

Name of the flow configured for the desired login or registration experience.

flow_version

string

Version number of the flow specified by the flow member..

form

string

Name of the form used for user profile updates.

forms_fields

string

Names of any other fields assigned to a profile management form. Each field needs be passed as a separate member. Use the field name as the key and the user input as the key value. The default editProfileForm includes emailAddress, firstName, lastName, and displayName as required fields.

locale

string

Defaults to en-US

Language code to use for the profile management experience. This member determines the language for any error messages returned to you and for any emails sent by Akamai to users.

redirect_uri

string

Either the redirect URL used to obtain an authorization code or the redirectUri setting configured in a JavaScript SDK-based implementation. Required only when the grant_type is set to authorization_code

token

string

One-time token used for social authentication. This is the token passed from the Social Login application to your token URL. The tome needs to be received from the same Social Login application configured for the API client calling this operation.

Responses

Language

Authentication

Remember to add your authentication credentials to run this code.

URL


xxxxxxxxxx
1
curl --request POST \
2
     --url https://hostname/oauth/link_account_native \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/x-www-form-urlencoded'


xxxxxxxxxx
 
1
{
2
  "stat": "ok"
3
}

200Successful response

400Invalid social login token.

403Invalid API client permissions. Invalid API client permissions. See Get started for information on configuring authentication for the Authentication API.

413Invalid registration access token.

500Invalid flow value.