Skip to main content
POST
/
users
/
{userID}
/
socialAccounts
Create a social login for a user
curl --request POST \
  --url https://backendapi.corbado.io/v2/users/{userID}/socialAccounts \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "providerType": "google",
  "identifierValue": "[email protected]",
  "foreignID": "53150919",
  "avatarURL": "https://avatars.githubusercontent.com/u/53150919?v=4",
  "fullName": "Jane Doe"
}
'
{
  "socialAccountID": "soc-6060375336139150919",
  "providerType": "github",
  "identifierValue": "[email protected]",
  "userID": "usr-4693224802260150919",
  "foreignID": "53150919",
  "avatarURL": "https://avatars.githubusercontent.com/u/53150919?v=4",
  "fullName": "Jane Doe"
}

Authorizations

​
Authorization
string
header
required

Basic authentication is used to authenticate requests to the Backend API. The username is the project ID and the password is the API secret.

The project ID and API secret can be found in the Developer Panel.

Path Parameters

​
userID
string
required

Unique identifier of the user. Format: usr-<number>.

Example:

"usr-4693224802260150919"

Body

application/json
​
providerType
enum<string>
required

Type of the social provider.

Available options:
google,
microsoft,
github
​
identifierValue
string
required

Login identifier of the user (here email address).

Example:

"[email protected]"

​
foreignID
string
required

Unique identifier of the user in the social provider.

Example:

"53150919"

​
avatarURL
string
required

URL of the avatar of the user in the social provider.

Example:

"https://avatars.githubusercontent.com/u/53150919?v=4"

​
fullName
string
required

Full name of the user in the social provider.

Example:

"Jane Doe"

Response

Social login has been created.

​
socialAccountID
string
required

Unique identifier of the social account.

Example:

"soc-6060375336139150919"

​
providerType
string
required

Type of the social provider.

Example:

"github"

​
identifierValue
string
required

Login identifier of the user (here email address).

Example:

"[email protected]"

​
userID
string
required

Unique identifier of the user.

Example:

"usr-4693224802260150919"

​
foreignID
string
required

Unique identifier of the user in the social provider.

Example:

"53150919"

​
avatarURL
string
required

URL of the avatar of the user in the social provider.

Example:

"https://avatars.githubusercontent.com/u/53150919?v=4"

​
fullName
string
required

Full name of the user in the social provider.

Example:

"Jane Doe"