POST
/
identities
Create a new identity with basic profile information.
curl --request POST \
  --url https://api.captaindata.com/v4/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.captaindata.test/identities/linkedin/login?token=XXXXXX"
  }
}
To automate Actions with Captain Data, 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

Response

200
application/json

Identity successfully created.

The response is of type object.