> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.airweave.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.airweave.ai/_mcp/server.

# Freshdesk

> Freshdesk integration with Airweave

{/* AUTO-GENERATED CONTENT START */}

<img src="https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/airweave.docs.buildwithfern.com/2026-05-20T11%3A36%3A51.367Z/docs/pages/connectors/freshdesk/icon.svg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260807%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260807T163220Z&X-Amz-Expires=604800&X-Amz-Signature=599f0285375c39ccbaf23eb9c9e75c375b38649f17cac1b944060956a3f09219&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject" alt="Freshdesk logo" width="48" height="48" />

<h1>
  Freshdesk
</h1>

This connector enables AI agents and RAG systems to retrieve context from Freshdesk through Airweave's unified search layer.

## Configuration

Freshdesk source connector.

Syncs tickets, conversations, contacts, companies, and solution articles from Freshdesk.

#### [View Source Code](https://github.com/airweave-ai/airweave/tree/main/backend/airweave/platform/sources/freshdesk.py)

Explore the Freshdesk connector implementation

### Authentication

**Supported authentication methods:**

* Direct Credentials
* Auth Provider

### Configuration Options

This connector does not have any additional configuration options.

## Data Models

The following data models are available for this connector:

#### FreshdeskTicketEntity

Schema for Freshdesk ticket entities.

Reference: [https://developers.freshdesk.com/api/#tickets](https://developers.freshdesk.com/api/#tickets)

| Field              | Type            | Description                                                    |
| ------------------ | --------------- | -------------------------------------------------------------- |
| ticket\_id         | int             | Unique identifier of the ticket                                |
| subject            | str             | Subject of the ticket                                          |
| created\_at\_value | datetime        | When the ticket was created.                                   |
| updated\_at\_value | datetime        | When the ticket was last updated.                              |
| web\_url\_value    | Optional\[str]  | UI URL to open the ticket in Freshdesk.                        |
| description        | Optional\[str]  | HTML content of the ticket                                     |
| description\_text  | Optional\[str]  | Plain text content of the ticket                               |
| status             | Optional\[int]  | Status of the ticket (2=Open, 3=Pending, 4=Resolved, 5=Closed) |
| priority           | Optional\[int]  | Priority (1=Low, 2=Medium, 3=High, 4=Urgent)                   |
| requester\_id      | Optional\[int]  | ID of the requester                                            |
| responder\_id      | Optional\[int]  | ID of the assigned agent                                       |
| company\_id        | Optional\[int]  | ID of the company                                              |
| group\_id          | Optional\[int]  | ID of the group                                                |
| type               | Optional\[str]  | Ticket type (e.g. Question, Problem)                           |
| source             | Optional\[int]  | Channel (1=Email, 2=Portal, 3=Phone, 7=Chat, etc.)             |
| tags               | List\[str]      | Tags associated with the ticket                                |
| custom\_fields     | Dict\[str, Any] | Custom field values                                            |

#### FreshdeskConversationEntity

Schema for Freshdesk conversation entities (replies and notes on a ticket).

Reference: [https://developers.freshdesk.com/api/#list-all-conversations-of-a-ticket](https://developers.freshdesk.com/api/#list-all-conversations-of-a-ticket)

| Field              | Type                | Description                                               |
| ------------------ | ------------------- | --------------------------------------------------------- |
| conversation\_id   | int                 | Unique identifier of the conversation                     |
| ticket\_id         | int                 | ID of the ticket this conversation belongs to             |
| ticket\_subject    | str                 | Subject of the parent ticket                              |
| body               | Optional\[str]      | HTML content of the conversation                          |
| body\_text         | str                 | Plain text content of the conversation                    |
| created\_at\_value | datetime            | When the conversation was created.                        |
| updated\_at\_value | Optional\[datetime] | When the conversation was last updated.                   |
| user\_id           | Optional\[int]      | ID of the user who created the conversation               |
| incoming           | bool                | True if from outside (e.g. customer reply)                |
| private            | bool                | True if the note is private                               |
| web\_url\_value    | Optional\[str]      | URL to the ticket (conversations don't have direct URLs). |

#### FreshdeskContactEntity

Schema for Freshdesk contact entities.

Reference: [https://developers.freshdesk.com/api/#contacts](https://developers.freshdesk.com/api/#contacts)

| Field              | Type            | Description                        |
| ------------------ | --------------- | ---------------------------------- |
| contact\_id        | int             | Unique identifier of the contact   |
| name               | str             | Name of the contact                |
| email              | Optional\[str]  | Primary email address              |
| created\_at\_value | datetime        | When the contact was created.      |
| updated\_at\_value | datetime        | When the contact was last updated. |
| web\_url\_value    | Optional\[str]  | URL to the contact in Freshdesk.   |
| company\_id        | Optional\[int]  | ID of the primary company          |
| job\_title         | Optional\[str]  | Job title                          |
| phone              | Optional\[str]  | Phone number                       |
| mobile             | Optional\[str]  | Mobile number                      |
| description        | Optional\[str]  | Description of the contact         |
| tags               | List\[str]      | Tags associated with the contact   |
| custom\_fields     | Dict\[str, Any] | Custom field values                |

#### FreshdeskCompanyEntity

Schema for Freshdesk company entities.

Reference: [https://developers.freshdesk.com/api/#companies](https://developers.freshdesk.com/api/#companies)

| Field              | Type            | Description                         |
| ------------------ | --------------- | ----------------------------------- |
| company\_id        | int             | Unique identifier of the company    |
| name               | str             | Name of the company                 |
| created\_at\_value | datetime        | When the company was created.       |
| updated\_at\_value | datetime        | When the company was last updated.  |
| web\_url\_value    | Optional\[str]  | URL to the company in Freshdesk.    |
| description        | Optional\[str]  | Description of the company          |
| note               | Optional\[str]  | Notes about the company             |
| domains            | List\[str]      | Domains associated with the company |
| custom\_fields     | Dict\[str, Any] | Custom field values                 |
| industry           | Optional\[str]  | Industry                            |

#### FreshdeskSolutionArticleEntity

Schema for Freshdesk solution/knowledge base article entities.

Reference: [https://developers.freshdesk.com/api/#articles](https://developers.freshdesk.com/api/#articles)

| Field              | Type           | Description                        |
| ------------------ | -------------- | ---------------------------------- |
| article\_id        | int            | Unique identifier of the article   |
| title              | str            | Title of the article               |
| created\_at\_value | datetime       | When the article was created.      |
| updated\_at\_value | datetime       | When the article was last updated. |
| web\_url\_value    | Optional\[str] | URL to the article in Freshdesk.   |
| description        | Optional\[str] | HTML content of the article        |
| description\_text  | Optional\[str] | Plain text content of the article  |
| status             | Optional\[int] | Status (1=draft, 2=published)      |
| folder\_id         | Optional\[int] | ID of the folder                   |
| category\_id       | Optional\[int] | ID of the category                 |
| folder\_name       | Optional\[str] | Name of the folder                 |
| category\_name     | Optional\[str] | Name of the category               |
| tags               | List\[str]     | Tags associated with the article   |

{/* AUTO-GENERATED CONTENT END */}