Bellwork
Book a demo
OrgCommunicationsLinkedin status

Whether you are connected to someone on LinkedIn

Looks a LinkedIn member up through the caller's own connected LinkedIn account and says whether they are connected, a request is pending, or neither — so a message is only offered to a connection. Pass `org_contact_id` or a profile `url`. Read-only, but it counts as a profile view on the caller's account.

GET
/org/communications/linkedin-status

Looks a LinkedIn member up through the caller's own connected LinkedIn account and says whether they are connected, a request is pending, or neither — so a message is only offered to a connection. Pass org_contact_id or a profile url. Read-only, but it counts as a profile view on the caller's account.

Authorization

AuthorizationBearer <token>

API key (sk_live_... prefix). Generate keys in the UI under Settings > API Keys, then send it as Authorization: Bearer sk_live_...

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://loading/api/v1/org/communications/linkedin-status"
{
  "data": {
    "state": "connected",
    "message": "string",
    "profile": {
      "providerId": "string",
      "publicIdentifier": "string",
      "name": "string",
      "headline": "string",
      "location": "string",
      "pictureUrl": "string",
      "relation": "string",
      "sharedConnections": 0,
      "isOpenProfile": true
    }
  }
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "module_required",
  "module": "string",
  "message": "string",
  "contact": "string"
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}

Search LinkedIn for people by name GET

LinkedIn's people search, run as the caller's own connected LinkedIn account, for writing to someone the contact book does not have. Spends one of that account's LinkedIn searches. A LinkedIn-side refusal returns an empty list with `error` and `message`.

People you can write to GET

The org's contacts, for the compose picker — name, title, district, and whether they can be reached by email or LinkedIn. Only reachable people are returned: someone with neither is a dead end dressed as a choice, and you would only find out after writing the message.