POST
/
identities
/
{identity_uid}
/
integrations
/
linkedin
Create or update a LinkedIn account
curl --request POST \
  --url https://api.captaindata.com/v4/identities/{identity_uid}/integrations/linkedin \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "auth_data": {
    "basic": {
      "username": "elon@musk.com",
      "password": "********"
    }
  }
}'
{
  "auth_type": "BASIC",
  "setup_source": "API",
  "is_shared": false,
  "name": "elon@musk.com LinkedIn Account",
  "uid": "123e4567-e89b-12d3-a456-426614174000",
  "integration_permalink": "linkedin",
  "created_at": "2023-10-01T12:00:00Z",
  "level": "Classic",
  "identity_uid": "5678e456-e89b-12d3-a456-426614174001",
  "checkpoint": {
    "type": "PHONE_REGISTER"
  }
}
Before connecting a LinkedIn account using email and password authentication, you must first Create an Identity to associate the account with. Once you have created an identity, you can use this endpoint to connect their LinkedIn account using their email and password credentials.
Checkpoint Handling: LinkedIn will likely require you to complete a checkpoint. Use the Resolve LinkedIn Checkpoint endpoint to handle this.The checkpoint endpoint supports various verification methods including mobile app approval, SMS codes, email verification, 2FA codes, and more. See the checkpoint documentation for detailed handling instructions for each checkpoint type.

Authorizations

​
X-API-Key
string
header
required

API key required for authentication. Add your API key in the X-API-Key header.

Path Parameters

​
identity_uid
string<uuid>
required

Body

application/json

Response

200
application/json

Successfully created or updated LinkedIn account.

The response is of type object.