Skip to main content
POST
/
identities
/
{identity_uid}
/
integrations
/
linkedin
Create or update a LinkedIn account
curl --request POST \
  --url https://api.edges.run/v1/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
​
auth_data
object

Response

Successfully created or updated LinkedIn account.

​
status
enum<string>
required
Available options:
VALID,
INVALID,
PENDING,
LIMIT_REACHED
​
identity_uid
string<uuid>
required
​
auth_type
enum<string> | null
Available options:
BASIC,
OAUTH,
COOKIES,
APIKEY
​
setup_source
enum<string> | null
Available options:
MANUAL,
EXTENSION,
SHARED,
API
​
is_shared
boolean
default:false
​
name
string | null
​
uid
string<uuid>
​
integration_permalink
string | null
​
created_at
string<date-time>
default:2025-10-01T00:00:00Z
​
updated_at
string<date-time> | null
​
level
string | null
​
user_uid
string<uuid> | null
​
meta
object | null
​
error
string | null
​
checkpoint
object | null