Saltar al contenido principal
POST
/
conversations
/
v3
/
conversations
/
threads
/
{threadId}
/
messages
Enviar un mensaje a una cadena
curl --request POST \
  --url https://api.hubapi.com/conversations/v3/conversations/threads/{threadId}/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "MESSAGE",
  "text": "<string>",
  "attachments": [
    {
      "fileId": "<string>",
      "type": "FILE"
    }
  ],
  "recipients": [
    {
      "deliveryIdentifiers": [
        {
          "type": "CHANNEL_SPECIFIC_OPAQUE_ID",
          "value": "<string>"
        }
      ],
      "actorId": "<string>",
      "name": "<string>",
      "recipientField": "<string>"
    }
  ],
  "senderActorId": "<string>",
  "channelId": "<string>",
  "channelAccountId": "<string>",
  "richText": "<string>",
  "subject": "<string>"
}
'
{
  "type": "MESSAGE",
  "id": "<string>",
  "conversationsThreadId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "createdBy": "<string>",
  "client": {
    "clientType": "HUBSPOT",
    "integrationAppId": 123
  },
  "senders": [
    {
      "actorId": "<string>",
      "deliveryIdentifier": {
        "type": "CHANNEL_SPECIFIC_OPAQUE_ID",
        "value": "<string>"
      },
      "name": "<string>",
      "senderField": "<string>"
    }
  ],
  "recipients": [
    {
      "deliveryIdentifier": {
        "type": "CHANNEL_SPECIFIC_OPAQUE_ID",
        "value": "<string>"
      },
      "actorId": "<string>",
      "name": "<string>",
      "recipientField": "<string>"
    }
  ],
  "archived": true,
  "text": "<string>",
  "attachments": [
    {
      "fileId": "<string>",
      "fileUsageType": "AUDIO",
      "type": "FILE",
      "name": "<string>",
      "url": "<string>"
    }
  ],
  "truncationStatus": "NOT_TRUNCATED",
  "direction": "INCOMING",
  "channelId": "<string>",
  "channelAccountId": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z",
  "richText": "<string>",
  "subject": "<string>",
  "inReplyToId": "<string>",
  "status": {
    "statusType": "FAILED",
    "failureDetails": {
      "errorMessageTokens": {},
      "errorMessage": "<string>"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt

Use this file to discover all available pages before exploring further.

Supported products

Autorizaciones

Authorization
string
header
requerido

The access token received from the authorization server in the OAuth 2.0 flow.

Parámetros de ruta

threadId
integer<int64>
requerido

Cuerpo

application/json
type
enum<string>
predeterminado:MESSAGE
requerido
Opciones disponibles:
MESSAGE
text
string
requerido
attachments
(FILE · object | QUICK_REPLIES · object | SOCIAL_MEDIA_METADATA · object)[]
requerido
recipients
object[]
requerido
senderActorId
string
requerido
channelId
string
requerido
channelAccountId
string
requerido
richText
string
subject
string

Respuesta

successful operation

type
enum<string>
predeterminado:MESSAGE
requerido
Opciones disponibles:
MESSAGE
id
string
requerido
conversationsThreadId
string
requerido
createdAt
string<date-time>
requerido
createdBy
string
requerido
client
object
requerido
senders
object[]
requerido
recipients
object[]
requerido
archived
boolean
requerido
text
string
requerido
attachments
(FILE · object | LOCATION · object | CONTACT · object | UNSUPPORTED_CONTENT · object | MESSAGE_HEADER · object | QUICK_REPLIES · object | WHATSAPP_TEMPLATE_METADATA · object | SOCIAL_MEDIA_METADATA · object)[]
requerido
truncationStatus
enum<string>
requerido
Opciones disponibles:
NOT_TRUNCATED,
TRUNCATED_TO_MOST_RECENT_REPLY,
TRUNCATED
direction
enum<string>
requerido
Opciones disponibles:
INCOMING,
OUTGOING
channelId
string
requerido
channelAccountId
string
requerido
updatedAt
string<date-time>
richText
string
subject
string
inReplyToId
string
status
object
Last modified on April 13, 2026