Messaging

Send an InMail

Sends a LinkedIn InMail from the account's own premium InMail credits to a member who is not a direct connection.

post/v1/{account_id}/messages/inmail

Request

  • Base URL: https://api.curviate.com
  • URL: https://api.curviate.com/v1/{account_id}/messages/inmail
  • Auth: HTTP bearer

Path parameters

account_idstring required

The account ID (acc_...) to send the InMail from.

Request body

recipient_urnstring required

LinkedIn member URN (urn:li:member:<id>) or member provider id (ACo...).

subjectstring required

InMail subject line (1-200 chars).

textstring required

InMail body text (1-8000 chars). This call keeps nothing and logs nothing. Once sent it is a message in the account's InMail inbox, so reading that chat back through Curviate stores its body in your tenant's inbox records, with no expiry.

Response

InMail sent. Returns message_id and chat_id.

object'inmail_sent' required

Response type discriminator.

chat_idstring required

The conversation thread identifier.

Example response

{
  "safety_warning": {
    "row": "profile_views",
    "reset_at": "2026-09-05T00:00:00.000Z",
    "hint": {
      "parameter": "profile_views.ceiling",
      "message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
    },
    "reason": "ceiling",
    "blocked": false
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.