v1

latestOpenAPI 3.0.1Apache 2.02026-07-1398228598.3 KB

Conversation

Change Conversation Opportunity

Links, updates, or removes an opportunity associated with a conversation. When an opportunity is linked, CRM intelligence fields may be recalculated unless explicitly skipped.

post/changeConversationOpportunity

Request body

conversation_idstring required

UUID of the conversation to update

opportunity_idstring

UUID of the opportunity to link. Required when linking or updating an opportunity.

entity_codestring

CRM entity code for the opportunity (e.g., 'salesforce', 'hubspot')

skip_intelligence_calculationboolean

When true, skips recalculating CRM intelligence fields after the opportunity change. Defaults to false.

remove_opportunityboolean

When true, removes the current opportunity from the conversation instead of linking one. Defaults to false.

Example request

{
  "conversation_id": "conv-uuid-123",
  "opportunity_id": "opp-uuid-456",
  "remove_opportunity": false,
  "skip_intelligence_calculation": false
}

Response

Opportunity changed successfully

successboolean required

Indicates whether the opportunity was changed successfully

Example response

{
  "success": true
}