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

Documentation Index

Fetch the complete documentation index at: https://docs.edges.run/llms.txt

Use this file to discover all available pages before exploring further.

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
​
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
​
meta
IntegrationAccountMeta · object
​
error
string | null
​
checkpoint
Checkpoint · object