Connect an Identity’s 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"
}
'

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    auth_data: {cookies: {li_at: 'example_li_at_token', li_a: 'example_li_a_token'}},
    account_name: 'Example Account 1'
  })
};

fetch('https://api.edges.run/v1/identities/{identity_uid}/integrations/{integration}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.edges.run/v1/identities/{identity_uid}/integrations/{integration}"

payload = {
    "auth_data": { "cookies": {
            "li_at": "example_li_at_token",
            "li_a": "example_li_a_token"
        } },
    "account_name": "Example Account 1"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "setup_source": "API",
  "auth_method": "BASIC",
  "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"
  },
  "status": "VALID",
  "last_synced_at": "2026-05-19T13:25:28.417259"
}

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"
}
'

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    auth_data: {cookies: {li_at: 'example_li_at_token', li_a: 'example_li_a_token'}},
    account_name: 'Example Account 1'
  })
};

fetch('https://api.edges.run/v1/identities/{identity_uid}/integrations/{integration}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.edges.run/v1/identities/{identity_uid}/integrations/{integration}"

payload = {
    "auth_data": { "cookies": {
            "li_at": "example_li_at_token",
            "li_a": "example_li_a_token"
        } },
    "account_name": "Example Account 1"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "setup_source": "API",
  "auth_method": "BASIC",
  "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"
  },
  "status": "VALID",
  "last_synced_at": "2026-05-19T13:25:28.417259"
}

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.

The response’s object with meta fields is also returned on your integration webhook present on your developpers settings

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

AuthData · object

required

Show child attributes

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

setup_source

enum<string> | null

Available options:

MANUAL,

EXTENSION,

SHARED,

API

auth_method

enum<string> | null

Available options:

BASIC,

OAUTH,

COOKIES,

APIKEY

is_shared

boolean

default:false

name

string | null

uid

string<uuid>

integration_permalink

string | null

created_at

string<date-time>

updated_at

string<date-time> | null

level

string | null

user_uid

string<uuid> | null