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

Base URL
https://api.attention.tech/v2
Auth
API key in header Authorization
TypeScript
https://skmtc.dev/attention/apis/attention-service-v2/docs/changeConversationOpportunity/post.ts
A function with typed inputs. Its response is checked against the schema.

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
}

Changes

No recorded changes to this operation across all 4 revisions of this API.