Skip to main content
Most mistakes with the API come from mixing up ids. Here is what each one means.

Which one to use

To reach someone, prefer ids in this order:
  1. conversation_id when you already talk to them. It goes straight to the right thread, but a conversation can be a group.
  2. linkedin_profile_id, which never changes.
  3. crm_contact_id, when you start from your CRM.
  4. linkedin_profile_slug as a last resort. A person can change their URL, and it can cost a live LinkedIn profile view.

Common traps

  • Send CRM ids as text. HubSpot and Affinity ids look like numbers, but send "12345", not 12345. On crm/contacts/sync-toggle, numbers are silently dropped.
  • A slug is not an id. john-smith goes in slug or linkedin_profile_slug, never in linkedin_profile_id.
  • conversation_id and chat_id are the same thing. linkedin/chat-messages takes the first and answers with the second.
  • member_urn and connection_urn are LinkedIn’s internal references. You can ignore them. Use linkedin_profile_id instead.