Skip to main content
POST
Check InMail

Overview

An Open Profile member can be InMailed without spending an InMail credit, whatever the connection degree. This action checks a batch of profiles in one call and returns, for each one, whether the InMail is free, plus the recipient_urn needed to send it. Uses the account’s Sales Nav seat — see Connect Account to activate it (it also auto-connects on first use). No Sales Nav? Use classic: true.
This endpoint consumes 1 credit per 10 profiles checked. Requires a Sales Nav seat on the account. Ignore this if you’re on per-seat pricing: usage is unlimited.
LinkedIn hides the Open Profile badge from some seats (typically a seat on its monthly InMail limit): every member then looks “not open” from that seat. The API detects this by checking known Open Profiles on the same seat. When the seat is blind, open_profile_badge_visible is false and a warning is included: open_profile and inmail_free keep LinkedIn’s raw value (false) but must not be trusted for that call. Check these profiles again from another seat, or use Check InMail Seat to know the seat’s state before batching.

Request

string
required
Your API key for authentication.
string
required
The unique identifier of the account to use. Must have a Sales Nav seat.
string
required
Must be "check_inmail".
object
required

Response

boolean
Indicates whether the request was successful.
object

Example

Classic Premium account

With classic: true, the check runs from the account’s own Premium InMail (Career, Business…), without a Sales Nav seat. It checks one profile per call, as LinkedIn does: pass a single profile URL, vanity slug or member id (ACoAA…) in profiles. For batches, use a Sales Nav seat. The result carries:
  • inmail_free / open_profile — the member is an Open Profile, the InMail costs no credit
  • can_send_inmail — false when the InMail is not free and the account has no InMail credit left
  • profile_urn — send with Send Message and premium_inmail: true
Same response shape as above, with mode: "classic": fields only a Sales Nav seat can see (degree, full_name, recipient_urn…) and open_profile_badge_visible are null. Requires a Premium account: LinkedIn only lets Premium members message Open Profiles.
Response

Recruiter

With recruiter: true, profiles are the candidates’ profile_urn (urn:li:ts_profile:…) from Search People Recruiter. The answer is data.profiles, one item per candidate:
  • profile_urn, name
  • can_receive_inmail — whether the seat can InMail them
  • inmail_cost — InMail credits it costs, inmail_free when 0
  • contacted_in_last_24h