Profiles

List LinkedIn profiles

Lists the LinkedIn profiles and company pages connected to the workspace: the integrationId values every post/schedule/carousel call needs.

GET/api/public/linkedin-profiles
cURLGET /api/public/linkedin-profiles
curl "https://postiv.ai/api/public/linkedin-profiles" \
  -H "Authorization: Bearer pk_postiv_..."
200Response
{
  "success": true,
  "profiles": [
    {
      "id": 1234,
      "provider": "linkedin",
      "profileType": "personal",
      "parentIntegrationId": null,
      "name": "Jan van Musscher",
      "headline": "Founder @ Postiv",
      "picture": "https://...",
      "status": "active"
    }
  ]
}

Authorization

Requires an organization API key with the profiles:read scope, sent as Authorization: Bearer or x-api-key.

Response

Connected profiles, personal (actor) profile first.

profiles[].idint

integrationId used everywhere else.

profiles[].providerstring

Always 'linkedin'.

profiles[].profileTypestring
profiles[].parentIntegrationIdint|null

Set for organization_page rows.

profiles[].namestring|null
profiles[].headlinestring|null
profiles[].picturestring|null

Resolved profile picture URL.

profiles[].statusstring

Always 'active' (query filters to active integrations).

Errors

404workspace_not_found: org_id doesn't resolve

Good to know

  • Agency admins in a client org are excluded from the member list this query joins against (their access is auto-granted, not seat-backed), matching the dual-membership seat rules in CLAUDE.md. Deliberately omits connected_at/expires_at: token lifecycle stays internal.