---
title: "Change Conversation Opportunity"
method: POST
path: "/changeConversationOpportunity"
tags: ["Conversation"]
---

# Change Conversation Opportunity

`POST /changeConversationOpportunity`

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

## Request body

- ChangeConversationOpportunityRequest
  - `conversation_id` string, required — UUID of the conversation to update
  - `opportunity_id` string — UUID of the opportunity to link. Required when linking or updating an opportunity.
  - `entity_code` string — CRM entity code for the opportunity (e.g., 'salesforce', 'hubspot')
  - `skip_intelligence_calculation` boolean — When true, skips recalculating CRM intelligence fields after the opportunity change. Defaults to false.
  - `remove_opportunity` boolean — When true, removes the current opportunity from the conversation instead of linking one. Defaults to false.

## Response `200`

Opportunity changed successfully

- ChangeConversationOpportunityResponse
  - `success` boolean, required — Indicates whether the opportunity was changed successfully

## Other responses

- `401` — Authentication failed - valid API key required
- `404` — Conversation not found
- `default` — Unexpected error occurred

---

[API](https://skmtc.net/attention/apis/attention-service-v2.md) · [All operations](https://skmtc.net/attention/apis/attention-service-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attention/attention-service-v2/versions/5de55d3804cf/schema)