Skip to main content
POST
/
identities
/
{identity_uid}
/
integrations
/
{integration}
Connect a identity to a platform like LinkedIn by authenticating them with cookies or credentials.
curl --request POST \
  --url https://api.edges.run/v1/identities/{identity_uid}/integrations/{integration} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "auth_data": {
    "cookies": {
      "li_at": "example_li_at_token",
      "li_a": "example_li_a_token"
    }
  },
  "account_name": "Example Account 1"
}'
{
  "auth_type": "COOKIES",
  "setup_source": "API",
  "is_shared": false,
  "name": "John Doe's Example Integration Account",
  "uid": "123e4567-e89b-12d3-a456-426614174000",
  "integration_permalink": "example-integration",
  "created_at": "2023-10-01T12:00:00Z",
  "level": "Classic",
  "identity_uid": "5678e456-e89b-12d3-a456-426614174001",
  "meta": {
    "key": "value"
  }
}
Connect an identity to an integration. An identity can only be connected to one integration per platform (one LinkedIn account for example). The data of an existing integration will be updated each time you call this endpoint if it has been connected before.
Before connecting an Integration, you must first Create an Identity to associate the integration with.
If you’re looking to connect natively to LinkedIn using email and password, check out this specific endpoint: Connect a LinkedIn Account (Username/Password)

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
​
integration
string
required

Body

application/json
​
auth_data
object
required
​
account_name
string | null

Optional name for the integration account. If not provided, a default name will be generated.

Response

Successfully created a new 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