> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkedcamp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Send a message

> **Destructive.** It sends, publishes, launches or deletes. Get a person to confirm before calling it.

Send a message into a conversation. THIS DELIVERS TO A REAL PERSON immediately, on LinkedIn or by email depending on the thread, and cannot be recalled or edited. No endpoint unsends it: `message_delete` only removes it from your own copy of the thread, and the recipient keeps it. Show the user the exact text and the recipient, and get an explicit yes in the conversation, before every call. Never send copy the user has not read, and never send to a thread they did not name. Sending by hand also stands the AI agent down on that thread when the agent has `pauseBotOnManualMessage` set, so one manual reply can stop the agent answering there. For a draft the user sends themselves use `message_draft_ai_reply`; to hand a thread to a human without sending anything, `conversation_update` with `assistant: false`.



## OpenAPI

````yaml /api-v2/openapi.json post /message_send
openapi: 3.1.0
info:
  title: LinkedCamp API
  version: 2.0.0
  description: >-
    Version 2 of the LinkedCamp API. Every endpoint is a POST to `/{endpoint}`
    with its arguments as a JSON object, and returns JSON.
servers:
  - url: https://api.linkedcamp.com/v2
security:
  - ApiKey: []
  - Bearer: []
tags:
  - name: Account
  - name: Notifications
  - name: Reference
  - name: Campaigns
  - name: Campaign audience
  - name: Sequences
  - name: Blocked dates
  - name: Leads
  - name: Lead notes
  - name: Activities
  - name: Tags
  - name: Blacklist
  - name: Conversations
  - name: Messages
  - name: Saved replies
  - name: Templates
  - name: Merge fields
  - name: Personalised images
  - name: LinkedIn accounts
  - name: Email accounts
  - name: AI agents
  - name: Knowledge base
  - name: Personas
  - name: Analytics
  - name: Posts
  - name: Posting schedule
  - name: Tasks
  - name: Appointments
  - name: Reminders
  - name: Automations
paths:
  /message_send:
    post:
      tags:
        - Messages
      summary: Send a message
      description: >-
        **Destructive.** It sends, publishes, launches or deletes. Get a person
        to confirm before calling it.


        Send a message into a conversation. THIS DELIVERS TO A REAL PERSON
        immediately, on LinkedIn or by email depending on the thread, and cannot
        be recalled or edited. No endpoint unsends it: `message_delete` only
        removes it from your own copy of the thread, and the recipient keeps it.
        Show the user the exact text and the recipient, and get an explicit yes
        in the conversation, before every call. Never send copy the user has not
        read, and never send to a thread they did not name. Sending by hand also
        stands the AI agent down on that thread when the agent has
        `pauseBotOnManualMessage` set, so one manual reply can stop the agent
        answering there. For a draft the user sends themselves use
        `message_draft_ai_reply`; to hand a thread to a human without sending
        anything, `conversation_update` with `assistant: false`.
      operationId: message_send
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                conversationId:
                  type: string
                  description: Conversation id, from `conversation_list`.
                content:
                  type: string
                  description: The message, exactly as it will be delivered.
                attachment:
                  type: object
                  properties:
                    url:
                      type: string
                      description: Publicly reachable URL of the file.
                    name:
                      type: string
                      description: File name shown to the recipient, e.g. "case-study.pdf".
                    type:
                      type: string
                      description: MIME type, e.g. "application/pdf".
                  required:
                    - url
                  additionalProperties: false
                  description: >-
                    Optional file to attach; must already be hosted at a
                    fetchable URL.
              required:
                - conversationId
                - content
              additionalProperties: false
      responses:
        '200':
          description: >-
            The result, as JSON. Writes answer `{ "ok": true, "message": ...,
            "data": ... }`.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '400':
          description: >-
            The body is not valid JSON, an argument is invalid, or the request
            was refused.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: No API key, or the key was rejected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: >-
            Your plan, permissions or access tier don't include this, or a
            record belongs to another account.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: A record named in the arguments does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: >-
            The request was valid but the operation was refused, such as
            launching a campaign that is not ready.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '502':
          description: The service failed or could not be reached. Reads are safe to retry.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '504':
          description: >-
            The operation timed out. A write may still complete; read it back
            before retrying.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              enum:
                - UNAUTHENTICATED
                - FORBIDDEN
                - PLAN_REQUIRED
                - VALIDATION
                - INVALID_JSON
                - NOT_FOUND
                - METHOD_NOT_ALLOWED
                - UPSTREAM
                - TOOL_ERROR
            message:
              type: string
            hint:
              type: string
              description: What to do about it, when there is something to do.
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-Api-Key
      description: Your LinkedCamp API key.
    Bearer:
      type: http
      scheme: bearer
      description: Your LinkedCamp API key as a bearer token.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.