Skip to main content
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"
}
'
{
  "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"
  }
}

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.

To automate Actions with Edges, you’ll need to create Identities. You have two options:
  1. Synchronize Your Own Users: Connect your existing users as identities
  2. Use Managed Accounts: Use our pre-configured accounts
Learn more about these options in our guide on When LinkedIn Identities Options: Sync, Rent, or Use Managed.

​
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. They are billed monthly based on the peak number of active Engagement Identities during your billing cycle (starting at $7.99/identity/month).
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.
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.
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

​
X-API-Key
string
header
required

API key required for authentication. Add your API key in the X-API-Key header.

Body

application/json
​
name
string
required

Name of the identity. Must be at least 3 characters long.

Minimum string length: 3
​
timezone
string
default:Europe/Paris

IANA-compliant timezone identifier used to localize timestamps. Follows the IANA time zone database (e.g. America/New_York, Europe/London)

​
type
enum<string>
default:standard

Specifies the type of identity. Determines if the identity is billed

Available options:
standard,
engagement

Response

Identity successfully created.

​
workspace_uid
string<uuid>
required
​
timezone
string
required
​
type
enum<string>
required
Available options:
standard,
engagement
​
uid
string<uuid>
​
created_at
string<date-time>
​
name
string | null
​
is_active
boolean
default:false
​
integrations
string[]
​
identity_login_links
IdentityLoginLinksModel · object