Skip to content
Home/
REST API Reference
/
/
Fin Agent Message

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)required

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 webhook 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"
}