Fin Agent Message | Intercom and Fin Developer Platform

Home/

REST API Reference

Fin Agent Message

A message exchanged within a Fin Agent conversation.

authorstringrequired

The author that created the message.

Enum:"user""agent""fin"

Example:"user"

bodystringrequired

The body of the message. Accepts both plain text and HTML format. When sending a message to Fin, this should contain the user's message. Fin's response will be returned as HTML.

Example:"How can I see my account details?"

timestampstring, (date-time)

The timestamp when the message was created. Used to deduplicate messages sent within a 5 minute window. Ideally should include milliseconds for higher precision.

Example:"2025-01-24T10:01:20.000Z"

timestamp_msstring, (date-time)

The timestamp when the message was created, with millisecond precision. Only present in event responses (fin_replied).

Example:"2025-01-24T10:01:20.456Z"

{
  "author": "user",
  "body": "How can I see my account details?",
  "timestamp": "2025-01-24T10:01:20.000Z",
  "timestamp_ms": "2025-01-24T10:01:20.456Z"
}