---
canonical_url: "https://docs.composio.dev/toolkits/fusedesk"
markdown_url: "https://docs.composio.dev/toolkits/fusedesk.md"
product: "platform"
version: null
last_updated: null
---

# FuseDesk

FuseDesk is a customer support platform for managing cases, email conversations, contacts, departments, representatives, chats, and webhooks.

- **Category:** customer support
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 27
- **Triggers:** 0
- **Slug:** `FUSEDESK`
- **Version:** 00000000_00

## Tools

### Add Case Note

**Slug:** `FUSEDESK_ADD_CASE_NOTE`

Add an internal note or call record to a case and optionally change its status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `note` | string | Yes | Full note or call details. |
| `title` | string | Yes | Short note or call title. |
| `rep_id` | integer | No | Rep responsible for the record. |
| `status` | string ("new" | "open" | "closed") | No | Optional resulting case status: new, open, or closed. |
| `case_id` | integer | Yes | Case receiving the record. |
| `record_type` | string ("note" | "call") | Yes | Type of record to add: note or call. |
| `template_id` | integer | No | Optional note template ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Merge Cases

**Slug:** `FUSEDESK_BULK_MERGE_CASES`

Irreversibly merge multiple FuseDesk cases. This cannot be undone; call only after the user explicitly requests a merge and verifies every case ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `case_ids` | array | Yes | FuseDesk case IDs to irreversibly merge. Provide at least two verified case IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Update Cases

**Slug:** `FUSEDESK_BULK_UPDATE_CASES`

Apply an assignment, department, status, tag, CRM automation, CRM tag, or snooze operation to multiple FuseDesk cases.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `status` | string ("new" | "open" | "closed" | "keepclosed" | "unopen") | No | Status to apply: new, open, closed, keepclosed, or unopen. |
| `rep_ids` | array | No | Rep assignment value or values to apply to the selected cases. |
| `tag_ids` | array | No | Tag IDs to apply to every selected case. |
| `case_ids` | array | Yes | FuseDesk case IDs to update. Provide at least one case ID. |
| `crm_tag_id` | integer | No | CRM tag to apply to each selected case's linked contact. |
| `snooze_until` | string | No | ISO 8601 date and time until which to snooze the selected cases. |
| `department_ids` | array | No | Department assignment value or values to apply to the selected cases. |
| `crm_automation_id` | integer | No | CRM automation to run for each selected case's linked contact. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Change Case Tag

**Slug:** `FUSEDESK_CHANGE_CASE_TAG`

Apply or remove one existing case tag from one FuseDesk case.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `case_id` | integer | Yes | FuseDesk case ID to modify. |
| `operation` | string ("apply" | "remove") | Yes | Tag change to perform: apply the tag or remove it. |
| `case_tag_id` | integer | Yes | Existing FuseDesk case-tag ID to apply or remove. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Close Chat

**Slug:** `FUSEDESK_CLOSE_CHAT`

Irreversibly close a FuseDesk chat and end the live conversation. This cannot be undone. Supplying rep_id, department_id, or case_status may also create and assign a new support case from the chat.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rep_id` | integer | No | Rep to assign if FuseDesk creates a case while closing the chat. Supplying case options may create a new case. |
| `chat_id` | string | Yes | Chat to close irreversibly. Closing ends the live conversation and cannot be undone. |
| `case_status` | string ("new" | "open" | "closed") | No | Status for a case optionally created from the chat: new, open, or closed. Supplying it may create a new case. |
| `department_id` | integer | No | Department to assign if FuseDesk creates a case while closing the chat. Supplying case options may create a new case. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Case

**Slug:** `FUSEDESK_CREATE_CASE`

Open a support case for a customer in a FuseDesk department.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rep_id` | integer | No | Rep to assign immediately. Omit to let FuseDesk select a rep. |
| `status` | string ("new" | "open" | "closed") | No | Initial case status: new, open, or closed. |
| `details` | string | Yes | Initial case details. |
| `summary` | string | Yes | Concise case subject. |
| `opened_by` | string | Yes | Identity or email of the person opening the case. |
| `company_id` | integer | No | CRM company ID to link. |
| `contact_id` | integer | No | Legacy contact ID to link when no UUID is available. |
| `date_opened` | string | No | Optional explicit opened timestamp in an ISO 8601 format FuseDesk accepts. |
| `case_tag_ids` | array | No | Existing case-tag IDs to apply. |
| `contact_uuid` | string | No | Current FuseDesk contact UUID to link. |
| `date_assigned` | string | No | Optional explicit assigned timestamp in an ISO 8601 format FuseDesk accepts. |
| `department_id` | integer | Yes | Department that owns the case. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Case Tag

**Slug:** `FUSEDESK_CREATE_CASE_TAG`

Create a reusable FuseDesk case tag.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag_name` | string | Yes | Name of the new FuseDesk case tag. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Contact

**Slug:** `FUSEDESK_CREATE_CONTACT`

Create a FuseDesk contact. FuseDesk also links the new contact to a matching contact in the connected CRM, or creates that CRM contact when no match exists.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company` | string | No | Company name. |
| `phone_1` | string | No | Primary phone number. |
| `phone_2` | string | No | Secondary phone number. |
| `website` | string | No | Contact website URL. |
| `last_name` | string | No | Last name. At least one name, email, or phone field is required. |
| `time_zone` | string | No | Contact timezone in a format FuseDesk accepts. |
| `first_name` | string | No | First name. At least one name, email, or phone field is required. |
| `email_address` | string | No | Primary email address. |
| `billing_address` | object | No | Billing address to store on the FuseDesk and linked CRM contact. |
| `email_address_2` | string | No | Secondary email address. |
| `email_address_3` | string | No | Third email address. |
| `phone_extension_1` | string | No | Primary phone extension. |
| `phone_extension_2` | string | No | Secondary phone extension. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Case

**Slug:** `FUSEDESK_GET_CASE`

Get one FuseDesk support case and its complete history by case ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `case_id` | integer | Yes | FuseDesk case ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Chat

**Slug:** `FUSEDESK_GET_CHAT`

Get one FuseDesk chat and its complete message history by chat UUID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chat_id` | string | Yes | FuseDesk chat UUID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contact

**Slug:** `FUSEDESK_GET_CONTACT`

Get a FuseDesk contact by UUID, including current data from its linked CRM contact.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | FuseDesk contact UUID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Department

**Slug:** `FUSEDESK_GET_DEPARTMENT`

Get a FuseDesk department's assignment, template, staleness, feedback, phone, and archive settings by department ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `department_id` | integer | Yes | Current v2 department ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Email

**Slug:** `FUSEDESK_GET_EMAIL`

Get one FuseDesk email by its numeric ID, including its complete body.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email_id` | integer | Yes | FuseDesk email ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Rep

**Slug:** `FUSEDESK_GET_REP`

Get a FuseDesk rep's detailed profile, permissions, and signatures.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | integer | Yes | Current v2 rep user ID, not the legacy repid. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Case Tags

**Slug:** `FUSEDESK_LIST_CASE_TAGS`

List available FuseDesk case tags and their case counts.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Chats

**Slug:** `FUSEDESK_LIST_CHATS`

List active FuseDesk chats across connected chat platforms, including assignment links, recent-message context, and lifecycle state.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Departments

**Slug:** `FUSEDESK_LIST_DEPARTMENTS`

List active, archived, or all FuseDesk departments using the current v2 representation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `state` | string ("active" | "archived" | "all") | No | Department state to return: active, archived, or all. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Reps

**Slug:** `FUSEDESK_LIST_REPS`

List active and disabled FuseDesk reps for assignment and ownership decisions.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Webhooks

**Slug:** `FUSEDESK_LIST_WEBHOOKS`

List configured FuseDesk webhook subscriptions.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Reply To Case

**Slug:** `FUSEDESK_REPLY_TO_CASE`

Send an external email reply on a FuseDesk case using supplied content or an existing reply template. This immediately emails the resolved recipients.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cc` | string | No | CC addresses. A valid template may supply this value when omitted. |
| `to` | string | No | Recipient addresses accepted by FuseDesk. Omit only when a valid template supplies the recipients. |
| `bcc` | string | No | BCC addresses. A valid template may supply this value when omitted. |
| `case_id` | integer | Yes | Case to reply on. |
| `html_body` | string | No | HTML reply body. Required unless text_body or template_id is provided. |
| `text_body` | string | No | Plain-text reply body. Required unless html_body or template_id is provided. |
| `template_id` | integer | No | Existing reply template ID. The template must be valid if recipient or sender fields are omitted. |
| `from_address` | string | No | Sender address accepted by FuseDesk. Omit only when a valid template supplies the sender. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Cases

**Slug:** `FUSEDESK_SEARCH_CASES`

Search support cases by customer, assignment, status, text, and lifecycle dates, returning one controllable page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Filter by customer email address. |
| `limit` | integer | No | Cases per page (1-500). |
| `sender` | string | No | Filter by originating sender. |
| `rep_ids` | array | No | Filter by assigned rep IDs. |
| `subject` | string | No | Filter by case subject or summary. |
| `order_by` | array | No | Provider-supported sort fields in priority order. |
| `statuses` | array | No | Filter by one or more of active, new, open, snoozed, or closed. |
| `company_id` | integer | No | Filter by CRM company ID. |
| `contact_id` | integer | No | Filter by legacy numeric contact ID. |
| `date_closed` | string | No | Provider date or date-range expression for closed time. |
| `date_opened` | string | No | Provider date or date-range expression for opened time. |
| `next_cursor` | string | No | Continuation token returned by a prior call; keep filters unchanged. |
| `contact_uuid` | string | No | Filter by current FuseDesk contact UUID. |
| `date_updated` | string | No | Provider date or date-range expression for last update. |
| `date_assigned` | string | No | Provider date or date-range expression for assigned time. |
| `department_ids` | array | No | Filter by department IDs. |
| `creator_rep_ids` | array | No | Filter by reps who created the cases. |
| `date_first_response` | string | No | Provider date or date-range expression for first response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Contacts

**Slug:** `FUSEDESK_SEARCH_CONTACTS`

Search FuseDesk and linked CRM contacts by required text. The connected API key must include FuseDesk's View Contacts permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search` | string | Yes | Required contact search text, such as a name, email address, phone number, or company. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Emails

**Slug:** `FUSEDESK_SEARCH_EMAILS`

Search all or only unassigned FuseDesk emails, returning one controllable page with optionally truncated bodies.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Emails per page (1-500). |
| `case_id` | integer | No | Filter by case ID; available only when mailbox is all. |
| `content` | string | No | Filter email content. |
| `mailbox` | string ("all" | "unassigned") | No | Search all emails or only unassigned emails. |
| `subject` | string | No | Filter subject. |
| `order_by` | string | No | Provider-supported email sort expression. |
| `body_limit` | string | No | Maximum body characters to return, or 'all' for the complete body. |
| `case_number` | string | No | Filter by case number; available only when mailbox is all. |
| `next_cursor` | string | No | Continuation token returned by a prior call; keep mailbox and filters unchanged. |
| `from_address` | string | No | Filter sender. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Snooze Case

**Slug:** `FUSEDESK_SNOOZE_CASE`

Snooze a case until an absolute date/time or FuseDesk relative-time expression.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `until` | string | Yes | Absolute datetime or FuseDesk-supported relative-time expression. |
| `case_id` | integer | Yes | Case to snooze. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Case

**Slug:** `FUSEDESK_UPDATE_CASE`

Change a case's content, customer link, assignment, department, or status. Provide at least one field to update.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rep_id` | integer | No | New assigned rep ID. |
| `status` | string ("new" | "open" | "closed" | "keepclosed" | "unopen") | No | New case status: new, open, closed, keepclosed, or unopen. |
| `case_id` | integer | Yes | Case to update. |
| `details` | string | No | Replacement details. |
| `summary` | string | No | Replacement summary. |
| `company_id` | integer | No | CRM company ID to relink. |
| `contact_id` | integer | No | Legacy contact ID to relink. |
| `contact_uuid` | string | No | Contact UUID to relink. |
| `department_id` | integer | No | New department ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Chat

**Slug:** `FUSEDESK_UPDATE_CHAT`

Rename, transfer, relink, or mark a live FuseDesk chat seen or unseen. Provide at least one field to update.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | New chat title. |
| `rep_id` | integer | No | Rep ID to assign to the chat. |
| `case_id` | integer | No | Case ID to link to the chat. |
| `chat_id` | string | Yes | FuseDesk chat UUID to update. |
| `client_name` | string | No | New client display name. |
| `contact_uuid` | string | No | FuseDesk contact UUID to link to the chat. |
| `unseen_count` | integer | No | New unseen-message count; use 0 to mark the chat as seen. |
| `department_id` | integer | No | Department ID to assign to the chat. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Contact

**Slug:** `FUSEDESK_UPDATE_CONTACT`

Update a FuseDesk contact. Warning: FuseDesk also updates the linked CRM contact, so confirm that both records should change before calling this tool. Provide at least one contact field or non-empty billing address to update.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company` | string | No | Updated company name. |
| `phone_1` | string | No | Updated primary phone. |
| `phone_2` | string | No | Updated secondary phone. |
| `website` | string | No | Updated website URL. |
| `last_name` | string | No | Updated last name. |
| `time_zone` | string | No | Updated contact timezone. |
| `contact_id` | string | Yes | FuseDesk contact UUID to update. |
| `first_name` | string | No | Updated first name. |
| `email_address` | string | No | Updated primary email. |
| `billing_address` | object | No | Billing address fields to update; omitted fields remain unchanged. |
| `email_address_2` | string | No | Updated secondary email. |
| `email_address_3` | string | No | Updated third email. |
| `phone_extension_1` | string | No | Updated primary phone extension. |
| `phone_extension_2` | string | No | Updated secondary phone extension. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |