Skip to main content
PATCH
Update Conversation customData

Overview

Update the per-conversation customData for an existing chat. customData is the prompt context exposed as {{customData}}, set when the conversation is created via the prospect import endpoints. Use this when the context that personalizes a conversation changes after import (for example, the lead performed a new action), so the AI prompt always uses the latest context.

Path parameters

Request body

Example

Response

Notes

  • The chat must belong to a campaign owned by your team, otherwise the request returns 403.
  • customData is truncated to 3000 characters.
  • An empty string clears the stored context (customDataSaved will be false).
  • The new value applies to subsequent AI message generations for the conversation.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

chatId
string
required

ID of the chat/conversation

Body

application/json
customData
string
required

Per-conversation prompt context. Empty string clears it.

Maximum string length: 3000
Example:

"John replied positively to the AI outbound post; reference that follow-up."

Response

Conversation customData updated successfully

message
string
Example:

"Conversation customData updated successfully"

chatId
string
Example:

"chat_12345abcde"

customDataSaved
boolean
Example:

true

customDataLength
integer
Example:

64

Last modified on June 25, 2026