curl --request POST \
--url https://openapi.enginy.ai/v1/identities/connection-link \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{}'{
"status": "success",
"message": "<string>",
"data": {
"url": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"host": {
"kind": "enginy",
"domain": "<string>"
},
"identityId": 123,
"canAddIdentity": true
}
}Create identity connection link
Create a one-time link where a person signs in to LinkedIn and connects an identity to this workspace, without an Enginy account: send it to the sales rep whose identity you are adding or reconnecting. With identityId the link reconnects that identity only; without it the person connects a new one (the workspace needs a free identity slot, see canAddIdentity). The link opens on the workspace’s white-label custom domain when its organization has a verified one (choose one with domain), otherwise on Enginy’s app. It expires after 24 hours and works once; while open, its session acts as the API key creator, who must be allowed to manage identities.
Required scope:
ALLRate limit: 10 requests per minute
curl --request POST \
--url https://openapi.enginy.ai/v1/identities/connection-link \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{}'{
"status": "success",
"message": "<string>",
"data": {
"url": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"host": {
"kind": "enginy",
"domain": "<string>"
},
"identityId": 123,
"canAddIdentity": true
}
}Authorizations
Body
Reconnect this existing identity: the link can only sign in to it. Omit it to let the recipient connect a new identity (the workspace needs a free identity slot).
x <= 2147483647The white-label custom domain the link opens on. Omit it to use the workspace organization's oldest verified custom domain, or Enginy's app when it has none. Must be a verified (ACTIVE) custom domain of the workspace's white-label organization.
3 - 253