Messaging

Start a chat

Starts a chat with members. This call keeps nothing and logs nothing. Once sent it is a message in the account's inbox, so reading that conversation back through Curviate stores its body in your tenant's inbox records, with no expiry. Company pages are reply-only: a COMPANY_ id cannot start one.

post/v1/{account_id}/chats

Request

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

Path parameters

account_idstring required

The account ID (acc_...) to start the chat from.

Request body

attendees_idsstring[] required

LinkedIn member provider IDs for the chat recipients (>= 1, e.g. ACo...).

textstring required

Opening message text (1-8000 chars).

subjectstring

Optional conversation name / subject line (<= 200 chars).

topic'service_request' | 'request_demo' | 'support' | 'careers' | 'other'

Mandatory when starting a conversation with a company. One of: service_request, request_demo, support, careers, other.

applicant_idstring

Required when messaging a job applicant.

invitation_idstring

Required when messaging a member whose invitation is pending.

inmailboolean

When true, starts the conversation as an InMail instead of a standard message.

Response

Chat started. Returns the chat_id and opening message_id.

object'chat_started' required

Response type discriminator.

chat_idstring required

The chat's identifier (existing thread reused when messaging a known 1:1 contact).

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.