> ## Documentation Index
> Fetch the complete documentation index at: https://docs.attention.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CRM

> Inspect and manage CRM integrations — Salesforce, HubSpot, Microsoft — and trigger field syncs.

The CRM tools let an MCP client see what CRM platforms are connected, create and update integration mappings (which CRM entities and fields sync into Attention), force-refresh field schemas after a CRM-side change, disconnect accounts, and start a fresh OAuth connection to a new CRM platform.

## Tools

### get\_crm\_integrations

> [!NOTE]
>
> Scope: `mcp:read`. No parameters.

List CRM integrations configured for your organization, including platform details, sync status, and entity field mappings.

**Returns:** Markdown list of CRM integrations with name, status, platform, entity type, mapped fields, and last sync time.

***

### create\_crm\_integration

> [!WARNING]
>
> Scope: `mcp:write`. Requires admin role.

Create a new CRM integration mapping CRM entity fields to Attention. Use `get_crm_integrations` to see existing integrations, and the OAuth flow via `connect_integration` to obtain a `crm_account_uuid`.

**crm\_platform\_uuid** `string` *required*

UUID of the CRM platform (Salesforce, HubSpot, etc.).

**crm\_entity\_uuid** `string` *required*

UUID of the CRM entity type to integrate.

**crm\_account\_uuid** `string` *required*

UUID of the connected CRM account.

**name** `string`

Display name for the integration.

**entity\_fields** `array`

List of CRM field names to sync.

**team\_id** `string`

Team UUID to scope the integration to.

**enabled** `boolean`

Whether the integration is active.

***

### update\_crm\_integration

> [!WARNING]
>
> Scope: `mcp:write`. Requires admin role.

Update an existing CRM integration's name, fields, or enabled status. The name should reflect the CRM entity type (e.g. `Deal Sync` for Opportunity entities).

**integration\_id** `string` *required*

UUID of the CRM integration to update.

**name** `string`

New display name.

**entity\_fields** `array`

New list of CRM field names to sync.

**enabled** `boolean`

Whether the integration is active.

***

### sync\_crm\_fields

> [!WARNING]
>
> Scope: `mcp:write`. Requires admin role.

Force-sync CRM entity and field definitions from the CRM platform. Useful after CRM schema changes (new custom fields, renamed fields, etc.).

**crm\_account\_uuid** `string` *required*

UUID of the CRM account to sync fields from.

***

### delete\_crm\_account

> [!WARNING]
>
> Scope: `mcp:write`. Requires admin role. Destructive and irreversible.

Disconnect a CRM account and remove all its integrations.

**crm\_account\_uuid** `string` *required*

UUID of the CRM account to disconnect.

***

### connect\_integration

> [!WARNING]
>
> Scope: `mcp:write`. Requires **user-level authentication**. Salesforce/HubSpot require admin role; Microsoft requires write access. The tool returns an OAuth URL — the user must open it in their browser to complete the connection.

Generate an OAuth authorization link to connect a CRM or calendar/email integration. After authorization, the connection is established automatically.

**provider** `string` *required*

Integration provider: `salesforce`, `hubspot`, or `microsoft`.

**salesforce\_domain** `string`

Required for Salesforce: your org domain (e.g. `my-company.my`). For sandbox use `my-company.sandbox.my`.

**services** `array`

For Microsoft only: services to connect — `calendar`, `email`, or both. Defaults to `["calendar"]`.

**Returns:** A user-facing block of text containing the OAuth URL and step-by-step instructions for the user to complete the flow in their browser.

See the [Salesforce integration guide](https://docs.attention.com/workspace-setup/salesforce-integration.md) for the full Salesforce setup walkthrough.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.