public

Create a new message

Send a new message to the specified thread.

post/public/v1/messages

Request

  • Base URL: https://api.gurusup.com
  • URL: https://api.gurusup.com/public/v1/messages
  • Auth: API key in header x-api-key

Request body

CreateMessageRequest required(unresolved $ref)

Response

Stable documented message fields. Public v1 may also return legacy properties; clients should ignore response properties they do not use.

fidstring nullable

Foreign identifier supplied by the integration

bodystring nullable

Message content/body text

subjectstring nullable

Message subject (email-type threads)

translated_bodystring nullable

Translated body, when the message was translated

translated_subjectstring nullable

Translated subject, when applicable

chat_bodystring[] nullable

Body split into chat bubbles (chat-type threads)

languagestring nullable

Detected language code (e.g. 'es', 'en')

threadstring required

Thread hash identifier

thread_fidstring required

Thread foreign identifier

thread_formatstring nullable

Thread format ('email' or 'chat')

user_fidstring nullable

Sender identifier (email, phone, or user id)

sender_namestring nullable

Display name of the sender

tostring nullable

Recipient address (email or phone)

ccstring[] nullable

CC recipients

integration_codestring required

Integration source code (e.g. 'API', 'WHATSAPP', 'GMAIL')

is_customer_support_agentboolean

True if sent by a human support agent

is_auto_replyboolean

True if generated as an automatic reply

readboolean

Whether the message has been read

archivedboolean

Whether the message is archived

is_translatedboolean

Whether the message was translated

timestampstring date-time required

Message timestamp

original_platform_urlstring nullable

Link to the message in the source platform

delivery_statusstring nullable

Delivery status, when tracked by the channel

delivery_error_codeinteger nullable

Channel error code for a failed delivery

delivery_error_categorystring nullable

Customer-safe delivery error category

delivery_retriableboolean nullable

Whether retrying the delivery may succeed

delivery_status_updated_atstring date-time nullable

When delivery status last changed

Example response

{
  "archived": false,
  "body": "Gracias por tu compra. ¿En qué puedo ayudarte?",
  "delivery_status": "sent",
  "fid": "msg-12345",
  "integration_code": "API",
  "is_auto_reply": false,
  "is_customer_support_agent": false,
  "is_translated": false,
  "language": "es",
  "read": false,
  "sender_name": "Jane Doe",
  "subject": "Order #6789",
  "thread": "3f8a1b2c4d5e6f70",
  "thread_fid": "conversation-6789",
  "thread_format": "email",
  "timestamp": "2026-07-15T10:30:00Z",
  "to": "support@yourcompany.com",
  "user_fid": "customer@example.com"
}

Changes

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