Freshdesk

Get a single forum by ID. Args: - id: The forum ID (required) - format: Response format (json, markdown) Returns: Forum details.

List all canned responses in a folder. Args: - folder_id: Folder ID (required) - format: Response format (json, markdown) Returns: List of canned responses in the folder.

Get a single canned response folder by ID. Args: - id: The folder ID (required) - format: Response format (json, markdown) Returns: Folder details.

Create a new canned response folder. Args: - name: Folder name (required) Returns: The created folder.

Delete a canned response folder. Args: - id: Folder ID (required) Returns: Confirmation of deletion.

Delete a solution article. Args: - id: Article ID (required) Returns: Confirmation of deletion.

List agents from Freshdesk with pagination and filtering. Args: - page: Page number (default: 1) - per_page: Agents per page (1-100, default: 30) - email: Filter by email - state: Filter by state (fulltime, occasional) - format: Response format (json, markdown) Returns: List of agents with their details.

Get a single agent by ID. Args: - id: The agent ID (required) - format: Response format (json, markdown) Returns: Complete agent details.

Get the currently authenticated agent. Args: - format: Response format (json, markdown) Returns: Details of the authenticated agent.

Update an existing agent. Args: - id: Agent ID (required) - occasional: Is occasional agent - signature: Email signature - ticket_scope: Ticket visibility scope - group_ids: Group IDs the agent belongs to - role_ids: Role IDs for the agent - skill_ids: Skill IDs for the agent Returns: The updated agent.

Delete an agent. Args: - id: Agent ID (required) Returns: Confirmation of deletion.

List agent groups from Freshdesk with pagination. Args: - page: Page number (default: 1) - per_page: Groups per page (1-100, default: 30) - format: Response format (json, markdown) Returns: List of groups with their details.

Get a single group by ID. Args: - id: The group ID (required) - format: Response format (json, markdown) Returns: Complete group details including agent IDs.

Create a new agent group. Args: - name: Group name (required) - description: Group description - business_hour_id: Business hour ID to apply - escalate_to: Group ID to escalate to - unassigned_for: Time string for unassigned escalation - agent_ids: Array of agent IDs to add - auto_ticket_assign: Enable auto ticket assignment Returns: The created group.

Update an existing group. Args: - id: Group ID (required) - name: New name - description: New description - business_hour_id: New business hour ID - escalate_to: New escalation group ID - agent_ids: New agent IDs array - auto_ticket_assign: Enable/disable auto assignment Returns: The updated group.

Delete a group. Args: - id: Group ID (required) Returns: Confirmation of deletion.

List all roles from Freshdesk. Args: - format: Response format (json, markdown) Returns: List of roles.

Get a single role by ID. Args: - id: The role ID (required) - format: Response format (json, markdown) Returns: Role details.

List all canned response folders. Args: - format: Response format (json, markdown) Returns: List of canned response folders.

Update a canned response folder. Args: - id: Folder ID (required) - name: New name (required) Returns: The updated folder.

Get a single canned response by ID. Args: - id: The canned response ID (required) - format: Response format (json, markdown) Returns: Canned response details including content.

Create a new canned response in a folder. Args: - folder_id: Folder ID (required) - title: Response title (required) - content: Response content (required) - content_html: HTML content (optional) Returns: The created canned response.

Update an existing canned response. Args: - id: Canned response ID (required) - title: New title - content: New content - content_html: New HTML content Returns: The updated canned response.

Delete a canned response. Args: - id: Canned response ID (required) Returns: Confirmation of deletion.

List companies from Freshdesk with pagination. Args: - page: Page number for pagination (default: 1) - per_page: Number of companies per page (1-100, default: 30) - format: Response format (json, markdown) Returns: List of companies with their details.

Get a single company by ID. Args: - id: The company ID (required) - format: Response format (json, markdown) Returns: Complete company details.

Create a new company. Args: - name: Company name (required) - domains: Array of company domains - description: Description - note: Note - health_score: Health score - account_tier: Account tier - renewal_date: Renewal date - industry: Industry Returns: The created company.

Update an existing company. Args: - id: Company ID (required) - name: New name - domains: New domains array - description: New description - note: New note - health_score: New health score - account_tier: New account tier - renewal_date: New renewal date - industry: New industry Returns: The updated company.

Delete a company. Args: - id: Company ID (required) Returns: Confirmation of deletion.

Search for companies using Freshdesk's search query syntax. Args: - query: Search query (e.g., "name:'Acme'", "domain:'acme.com'") - page: Page number (1-10) - format: Response format (json, markdown) Returns: Matching companies and total count.

Get a single forum category by ID. Args: - id: The category ID (required) - format: Response format (json, markdown) Returns: Category details.

List all forums in a category. Args: - category_id: Category ID (required) - format: Response format (json, markdown) Returns: List of forums in the category.

List contacts from Freshdesk with pagination and filtering. Args: - page: Page number for pagination (default: 1) - per_page: Number of contacts per page (1-100, default: 30) - email: Filter by email address - phone: Filter by phone number - mobile: Filter by mobile number - company_id: Filter by company ID - state: Filter by state (verified, unverified, blocked, deleted) - updated_since: Return contacts updated after this date (ISO 8601) - format: Response format (json, markdown) Returns: List of contacts with their details.

Get a single contact by ID. Args: - id: The contact ID (required) - format: Response format (json, markdown) Returns: Complete contact details.

List all products from Freshdesk. Args: - format: Response format (json, markdown) Returns: List of products.

Create a new contact. Args: - name: Contact name (required) - email: Email address - phone: Phone number - mobile: Mobile number - twitter_id: Twitter handle - unique_external_id: External ID - company_id: Associated company ID - view_all_tickets: Can view all company tickets - address: Address - description: Description - job_title: Job title - language: Language - time_zone: Time zone - tags: Array of tags Returns: The created contact.

Update an existing contact. Args: - id: Contact ID (required) - name: New name - email: New email - phone: New phone - mobile: New mobile - company_id: New company ID - address: New address - description: New description - job_title: New job title - tags: New tags array Returns: The updated contact.

Soft delete a contact (can be restored). Args: - id: Contact ID (required) Returns: Confirmation of deletion.

Restore a soft-deleted contact. Args: - id: Contact ID (required) Returns: Confirmation of restoration.

Permanently delete a contact (cannot be undone). Args: - id: Contact ID (required) Returns: Confirmation of permanent deletion.

Search for contacts using Freshdesk's search query syntax. Args: - query: Search query (e.g., "email:'john@example.com'", "company_id:123") - page: Page number (1-10) - format: Response format (json, markdown) Returns: Matching contacts and total count.

Merge multiple contacts into one primary contact. Args: - primary_id: ID of the primary contact to keep (required) - secondary_ids: Array of contact IDs to merge into primary (required) Returns: Confirmation of merge.

Convert a contact into an agent. Args: - id: Contact ID (required) Returns: The newly created agent.

List all forum categories. Args: - format: Response format (json, markdown) Returns: List of forum categories.

List all topics in a forum. Args: - forum_id: Forum ID (required) - page: Page number - per_page: Topics per page - format: Response format (json, markdown) Returns: List of topics in the forum.

Get a single topic by ID. Args: - id: The topic ID (required) - format: Response format (json, markdown) Returns: Topic details.

List all comments on a topic. Args: - topic_id: Topic ID (required) - page: Page number - per_page: Comments per page - format: Response format (json, markdown) Returns: List of comments on the topic.

Get a single product by ID. Args: - id: The product ID (required) - format: Response format (json, markdown) Returns: Product details.

Create a new product. Args: - name: Product name (required) - description: Product description - primary_email: Primary support email Returns: The created product.

Update an existing product. Args: - id: Product ID (required) - name: New name - description: New description - primary_email: New primary email Returns: The updated product.

Delete a product. Args: - id: Product ID (required) Returns: Confirmation of deletion.

List all business hours configurations. Args: - format: Response format (json, markdown) Returns: List of business hours.

Get a single business hour configuration by ID. Args: - id: The business hour ID (required) - format: Response format (json, markdown) Returns: Business hour details including schedule.

List all SLA policies. Args: - format: Response format (json, markdown) Returns: List of SLA policies.

Get a single SLA policy by ID. Args: - id: The SLA policy ID (required) - format: Response format (json, markdown) Returns: SLA policy details including targets and escalation rules.

List all email configurations. Args: - format: Response format (json, markdown) Returns: List of email configurations.

Get a single email configuration by ID. Args: - id: The email config ID (required) - format: Response format (json, markdown) Returns: Email configuration details.

List all ticket fields (including custom fields). Args: - format: Response format (json, markdown) Returns: List of ticket fields with their properties.

Get a single ticket field by ID. Args: - id: The ticket field ID (required) - format: Response format (json, markdown) Returns: Ticket field details including choices if applicable.

List all solution (knowledge base) categories. Args: - format: Response format (json, markdown) Returns: List of solution categories.

Get a single solution category by ID. Args: - id: The category ID (required) - format: Response format (json, markdown) Returns: Category details.

Create a new solution category. Args: - name: Category name (required) - description: Category description - visible_in_portals: Array of portal IDs Returns: The created category.

Update an existing solution category. Args: - id: Category ID (required) - name: New name - description: New description Returns: The updated category.

Delete a solution category. Args: - id: Category ID (required) Returns: Confirmation of deletion.

List all folders in a solution category. Args: - category_id: Category ID (required) - format: Response format (json, markdown) Returns: List of folders in the category.

Get a single solution folder by ID. Args: - id: The folder ID (required) - format: Response format (json, markdown) Returns: Folder details.

Create a new solution folder in a category. Args: - category_id: Category ID (required) - name: Folder name (required) - description: Folder description - visibility: Visibility level (1=All users, 2=Logged in users, 3=Agents only) Returns: The created folder.

Update an existing solution folder. Args: - id: Folder ID (required) - name: New name - description: New description - visibility: New visibility level Returns: The updated folder.

Delete a solution folder. Args: - id: Folder ID (required) Returns: Confirmation of deletion.

List all articles in a solution folder. Args: - folder_id: Folder ID (required) - format: Response format (json, markdown) Returns: List of articles in the folder.

Get a single solution article by ID. Args: - id: The article ID (required) - format: Response format (json, markdown) Returns: Article details including content.

Create a new solution article in a folder. Args: - folder_id: Folder ID (required) - title: Article title (required) - description: Article content in HTML (required) - status: Article status (1=Draft, 2=Published) - tags: Array of tags Returns: The created article.

Update an existing solution article. Args: - id: Article ID (required) - title: New title - description: New content (HTML) - status: New status (1=Draft, 2=Published) - tags: New tags array Returns: The updated article.

Search for solution articles by keyword. Args: - term: Search term (required) - format: Response format (json, markdown) Returns: Matching articles.

List all surveys. Args: - format: Response format (json, markdown) Returns: List of surveys.

Get a single survey by ID. Args: - id: The survey ID (required) - format: Response format (json, markdown) Returns: Survey details.

List satisfaction ratings with pagination and filtering. Args: - page: Page number (default: 1) - per_page: Ratings per page (1-100, default: 30) - created_since: Filter ratings created after this date (ISO 8601) - format: Response format (json, markdown) Returns: List of satisfaction ratings.

Get satisfaction ratings for a specific ticket. Args: - ticket_id: Ticket ID (required) - format: Response format (json, markdown) Returns: Satisfaction ratings for the ticket.

List all conversations (notes and replies) on a ticket. Args: - ticket_id: Ticket ID (required) - page: Page number - per_page: Items per page - format: Response format Returns: List of conversations on the ticket.

Update a conversation (note or reply). Args: - id: Conversation ID (required) - body: New body content (HTML) Returns: The updated conversation.

List support tickets from Freshdesk with pagination and filtering. Args: - page: Page number for pagination (default: 1) - per_page: Number of tickets per page (1-100, default: 30) - filter: Predefined filter (new_and_my_open, watching, spam, deleted) - order_by: Field to order by (created_at, due_by, updated_at, status) - order_type: Sort direction (asc, desc) - updated_since: Return tickets updated after this date (ISO 8601) - format: Response format (json, markdown) Returns: List of tickets with id, subject, status, priority, and timestamps.

Get a single ticket by ID with full details. Args: - id: The ticket ID (required) - include: Comma-separated list of related objects to include (conversations, requester, company, stats) - format: Response format (json, markdown) Returns: Complete ticket details including subject, description, status, priority, tags, and custom fields.

Get a single time entry by ID. Args: - id: The time entry ID (required) - format: Response format (json, markdown) Returns: Time entry details.

Create a new time entry on a ticket. Args: - ticket_id: Ticket ID (required) - time_spent: Time spent string (e.g., "01:30" for 1h 30m) (required) - agent_id: Agent ID (defaults to authenticated agent) - billable: Is billable - note: Note text - executed_at: When the time was spent (ISO 8601) Returns: The created time entry.

Create a new support ticket. Args: - subject: Ticket subject (required) - description: Ticket description in HTML (required) - email: Requester email (required if no requester_id) - requester_id: Requester contact ID (alternative to email) - status: Ticket status (2=Open, 3=Pending, 4=Resolved, 5=Closed) - priority: Ticket priority (1=Low, 2=Medium, 3=High, 4=Urgent) - type: Ticket type (e.g., Question, Incident, Problem) - source: Ticket source (1=Email, 2=Portal, 3=Phone, 7=Chat) - responder_id: Agent ID to assign - group_id: Group ID to assign - product_id: Product ID - tags: Array of tags - cc_emails: Array of CC email addresses Returns: The created ticket with its ID and details.

Update an existing ticket. Args: - id: Ticket ID (required) - subject: New subject - description: New description (HTML) - status: New status (2=Open, 3=Pending, 4=Resolved, 5=Closed) - priority: New priority (1=Low, 2=Medium, 3=High, 4=Urgent) - type: New ticket type - responder_id: New agent ID - group_id: New group ID - tags: New tags array Returns: The updated ticket.

Delete a ticket (moves to trash). Args: - id: Ticket ID (required) Returns: Confirmation of deletion.

Restore a deleted ticket from trash. Args: - id: Ticket ID (required) Returns: Confirmation of restoration.

Search for tickets using Freshdesk's search query syntax. Args: - query: Search query (e.g., "priority:4", "status:2", "tag:'urgent'") - page: Page number (1-10, max 300 results) - format: Response format (json, markdown) Returns: Matching tickets and total count.

Reply to a ticket (sends email to requester). Args: - ticket_id: Ticket ID (required) - body: Reply body in HTML (required) - cc_emails: CC email addresses - bcc_emails: BCC email addresses Returns: The created conversation.

Add a note to a ticket. Args: - ticket_id: Ticket ID (required) - body: Note body in HTML (required) - private: Whether note is private (default: true) - notify_emails: Email addresses to notify Returns: The created note.

Delete a conversation (note or reply). Args: - id: Conversation ID (required) Returns: Confirmation of deletion.

List time entries from Freshdesk with pagination and filtering. Args: - page: Page number (default: 1) - per_page: Entries per page (1-100, default: 30) - billable: Filter by billable status - agent_id: Filter by agent ID - executed_after: Filter entries executed after this date - executed_before: Filter entries executed before this date - format: Response format (json, markdown) Returns: List of time entries.

List time entries for a specific ticket. Args: - ticket_id: Ticket ID (required) - format: Response format (json, markdown) Returns: List of time entries on the ticket.

Update an existing time entry. Args: - id: Time entry ID (required) - time_spent: New time spent string - billable: New billable status - note: New note - executed_at: New executed date Returns: The updated time entry.

Delete a time entry. Args: - id: Time entry ID (required) Returns: Confirmation of deletion.

Toggle the timer on a time entry (start/stop). Args: - id: Time entry ID (required) Returns: The updated time entry with timer status.