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"
}'
{
  "uid": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2023-10-01T12:00:00Z",
  "workspace_uid": "5678e456-e89b-12d3-a456-426614174001",
  "name": "John Doe",
  "timezone": "Europe/Paris",
  "integrations": [],
  "identity_login_links": {
    "linkedin": "https://app.edges.test/identities/linkedin/login?token=XXXXXX"
  }
}
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 Rented Accounts: Use our pre-configured accounts
Learn more about these options in our guide on When LinkedIn Identities Options: Sync, Rent, or Use Managed. 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 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)

Response

Identity successfully created.

​
workspace_uid
string<uuid>
required
​
timezone
string
required
​
uid
string<uuid>
​
created_at
string<date-time>
default:2025-10-01T00:00:00Z
​
name
string | null
​
integrations
string[]
​
identity_login_links
object | null