API Reference/Endpoints

Send a connection request or message

POST/api/linkedin/accounts/{account_id}/actions

Sends a connection invitation or a first message from a connected account to any public LinkedIn profile URL.

Authentication

Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401. The account addressed by account_id must already be connected (see Check connection status).

Path parameters

FieldTypeDescription

account_id *stringA connected account's id.

Body parameters

FieldTypeDescription

type *"invite" | "message"Whether to send a connection request or open a chat.

profile_url *stringA public linkedin.com/in/... profile URL.

messagestringA note to include. Optional for invite, required for message.

Response fields

FieldTypeDescription

resultobjectProvider result: { object, invitation_id } for an invite, { object, chat_id } for a message.

Every send is logged regardless of outcome — LinkedIn's own webhooks only report a connection once it's accepted, so this call is the only record of the send itself.

Errors

·400 Bad Request. type or profile_url is missing, or message is missing for type=message.·401 Unauthorized. The key is missing, malformed or has been rotated.·404 Not Found. No account with that id belongs to this key.·409 Conflict. The account isn't connected yet.·502 Bad Gateway. The LinkedIn engine rejected or failed the send.