---
title: "Update Linked CRM Records"
method: PUT
path: "/conversations/{id}/linked-crm-records"
tags: ["Conversation", "CRM"]
---

# Update Linked CRM Records

`PUT /conversations/{id}/linked-crm-records`

## Request

- Base URL: `https://api.attention.tech/v2`
- URL: `https://api.attention.tech/v2/conversations/{id}/linked-crm-records`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/attention/apis/attention-service-v2/docs/conversations/:id/linked-crm-records/put.ts> (a function with typed inputs; its response is checked against the schema)

Updates the CRM records (accounts, contacts, etc.) linked to a conversation. Replaces the current set of linked records with the provided list.

## Path parameters

- `id` string, required

## Request body

- UpdateLinkedCrmRecordsRequest
  - `opportunity_id` string: UUID of the opportunity to associate the CRM records with
  - `linked_crm_records` LinkedCrmRecordInput[]: List of CRM records to link to the conversation
    - `id` string, required: External CRM record ID
    - `code` string, required: CRM entity type code (e.g., 'salesforce_account', 'hubspot_contact')

## Response `200`

Linked CRM records updated successfully

- UpdateLinkedCrmRecordsResponse
  - `success` boolean, required: Indicates whether the linked CRM records were updated successfully

## Other responses

- `400`: Invalid request parameters
- `401`: Authentication failed - valid API key required
- `404`: Conversation not found
- `default`: Unexpected error occurred

---

[API](https://skmtc.dev/attention/apis/attention-service-v2.md) - [All operations](https://skmtc.dev/attention/apis/attention-service-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/attention/apis/attention-service-v2/revisions/cd99c71f42bb?raw)