Skip to main content
GET

Overview

Returns the raw file for an attachment received in a message — on LinkedIn (classic messaging and the Recruiter mailbox), email (Gmail / Outlook) and WhatsApp accounts. LinkedIn’s own media URL requires the account session and its signature expires, so this endpoint re-resolves it on demand; for email the bytes are fetched over the mailbox API. For LinkedIn, every attachment in a webhook payload (and in a Recruiter Get Conversation) already carries a ready-to-call download_url — see Webhooks Introduction. For email, use the attachments[] from Get Conversation. You still send your x-api-key header.
This endpoint costs 1 credit per successful download. Nothing is stored on our side. Ignore this if you’re on per-seat pricing: usage is unlimited.

Request

string
required
Your API key for authentication.
string
required
The account the message belongs to.
string
(LinkedIn, classic messaging) The conversation URN, from event.metadata.conversation_urn.
string
(LinkedIn) The attachment identifier, from attachments[].asset_urn.
string
(Email + WhatsApp) The id of the message carrying the attachment (attachments[].message_id). (LinkedIn Recruiter) The message URN (urn:li:ts_msg_message:…): event.metadata.entity_urn in a webhook, messages[].entity_urn in Get Conversation. A Recruiter file is signed per message, so it takes message_id instead of conversation_id, with account_id set to the Recruiter seat.
string
(Email) The attachment id (attachments[].attachment_id).
string
(Email + LinkedIn Recruiter) Optional filename for the download.

Response

On success, the raw file with its own Content-Type (and Content-Disposition when a filename is known) — not the usual JSON envelope. On failure, the standard V2 error envelope: