# LinkedIn Messages

Send and retrieve LinkedIn messages through your connected sender profiles.

**LinkedIn message types:** `connection_note`, `message`, `InMail`.

**Message statuses:** `new`, `in_progress`, `done`, `failed`.

**Automation field:** `auto` (sent by automation), `manual` (sent by user), `synced` (incoming message synced from LinkedIn).


## List LinkedIn messages

 - [GET /flows/api/linkedin-messages](https://api.grinfi.io/openapi/linkedin-messages/listlinkedinmessages.md): Retrieve LinkedIn messages from your unified inbox. Filter by contact, sender profile, conversation, message type (inbox/outbox), and status.

## Send a LinkedIn message

 - [POST /flows/api/linkedin-messages](https://api.grinfi.io/openapi/linkedin-messages/sendlinkedinmessage.md): Send a LinkedIn message to a contact through a sender profile. The message will be queued and sent via the linked LinkedIn account.

## Delete a LinkedIn message

 - [DELETE /flows/api/linkedin-messages/{uuid}](https://api.grinfi.io/openapi/linkedin-messages/deletelinkedinmessage.md): Delete a LinkedIn message record.

## Retry a failed LinkedIn message

 - [PUT /flows/api/linkedin-messages/{uuid}/retry](https://api.grinfi.io/openapi/linkedin-messages/retrylinkedinmessage.md): Retry sending a LinkedIn message that previously failed.

## Group counts for LinkedIn messages

 - [POST /flows/api/linkedin-messages/group-counts](https://api.grinfi.io/openapi/linkedin-messages/groupcountlinkedinmessages.md): Returns counts of LinkedIn messages grouped by status or type. Optionally scoped by sender profile via filter.sender_profile_uuid. Filter by created_at is not supported — counts are all-time totals.

Note: this endpoint is the closest available to per-sender activity counts.