Create a new identity with basic profile information.
curl --request POST \
--url https://api.edges.run/v1/identities \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"name": "John Doe",
"timezone": "Europe/Paris",
"type": "standard"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'John Doe', timezone: 'Europe/Paris', type: 'standard'})
};
fetch('https://api.edges.run/v1/identities', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.edges.run/v1/identities"
payload = {
"name": "John Doe",
"timezone": "Europe/Paris",
"type": "standard"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"uid": "123e4567-e89b-12d3-a456-426614174000",
"created_at": "2023-10-01T12:00:00Z",
"workspace_uid": "5678e456-e89b-12d3-a456-426614174001",
"name": "John Doe",
"type": "standard",
"timezone": "Europe/Paris",
"integrations": [],
"identity_login_links": {
"linkedin": "https://app.edges.run/identities/linkedin/login?token=XXXXXX"
}
}
Identities
Create an Identity
Create an identity to represent one of your end users, before connecting a LinkedIn account to it.
POST
/
identities
Create a new identity with basic profile information.
curl --request POST \
--url https://api.edges.run/v1/identities \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"name": "John Doe",
"timezone": "Europe/Paris",
"type": "standard"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'John Doe', timezone: 'Europe/Paris', type: 'standard'})
};
fetch('https://api.edges.run/v1/identities', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.edges.run/v1/identities"
payload = {
"name": "John Doe",
"timezone": "Europe/Paris",
"type": "standard"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"uid": "123e4567-e89b-12d3-a456-426614174000",
"created_at": "2023-10-01T12:00:00Z",
"workspace_uid": "5678e456-e89b-12d3-a456-426614174001",
"name": "John Doe",
"type": "standard",
"timezone": "Europe/Paris",
"integrations": [],
"identity_login_links": {
"linkedin": "https://app.edges.run/identities/linkedin/login?token=XXXXXX"
}
}
To automate Actions with Edges, you’ll need to create Identities. You have two options:
Once you’ve created an Identity, connect them to platforms like LinkedIn using the Connect an Identity’s’ Integration endpoint.
Read everything you need to know about Adding & Managing Identities.
- Synchronize Your Own Users: Connect your existing users as identities
- Use Managed Accounts: Use our pre-configured accounts
Identity Modes
BYO or Managed, and how a run picks which account to use.
Identity Types
When creating an identity, you can specify its type:standard(default): Standard identity included in your plan. All actions consume credits at the normal rate.engagement: Engagement identity that allows running a broad set of LinkedIn outreach actions (connect, message, follow, like, comment, etc.) without consuming credits. Ideal for building SaaS products or AI agents that enable users to engage on LinkedIn or create outreach sequences.
Engagement Identities must be enabled first from the Developer Settings page and require billing details to be filled. Billing follows the contract — a monthly peak of active identities, or a fixed pool. See Pricing & Billing.
Use Engagement Identities for high-volume, repetitive outreach actions (connect, message, follow) and keep standard identities for more occasional or data extraction workflows. See Engagement Identities for more details.
Important: The identity
type cannot be changed after creation. If you need to change an identity’s type, you must delete the existing identity and create a new one with the desired type.identity_login_links are secure, 48-hour valid URLs that let users connect their integration accounts (like LinkedIn) without a browser extension.
Users authenticate through our white-labeled interface, and you can share these links via email or embed them in your product.
Once connected, the integration is ready to use with our API.Authorizations
API key required for authentication. Add your API key in the X-API-Key header.
Body
application/json
Name of the identity. Must be at least 3 characters long.
Minimum string length:
3IANA-compliant timezone identifier used to localize timestamps. Follows the IANA time zone database (e.g. America/New_York, Europe/London)
Specifies the type of identity. Determines if the identity is billed
Available options:
standard, engagement Response
Identity successfully created.
Available options:
standard, engagement Show child attributes
Show child attributes