create_time_entry
Create Time Entry
Logs a time entry on a ticket. Supports setting time spent, billable status, agent, and notes.
create_time_entry
Logs a time entry on a ticket. Supports setting time spent, billable status, agent, and notes.
create_article
Creates a new knowledge base article in a specified folder. Supports HTML content, tags, SEO metadata, and draft/published status.
list_time_entries
Lists all time entries logged on a specific ticket. Shows agent, hours spent, billable status, and notes.
create_contact
Creates a new contact in Freshdesk. Contacts represent customers who submit support tickets. Supports email, phone, company association, tags, and custom fields.
list_agents
Lists agents in the Freshdesk helpdesk. Can filter by email or state. Returns agent details including contact information, roles, and group memberships.
create_company
Creates a new company in Freshdesk. Companies group contacts and can be associated with tickets. Supports domains for automatic contact association, industry classification, and custom fields.
update_company
Updates an existing company's details. Only provide the fields you want to change.
update_contact
Updates an existing contact's details. Only provide the fields you want to change.
get_ticket
Retrieves a single ticket by ID with full details. Optionally includes conversations, requester info, company info, and stats (resolution/response times).
list_tickets
Lists tickets from Freshdesk with optional filtering, ordering, and pagination. Can filter by updated timestamp and include related data. Returns up to 30 tickets per page.
search_tickets
Searches tickets using Freshdesk's filter query language. Supports filtering by standard and custom fields with logical operators. Example queries: `"status:2 AND priority:4"`, `"agent_id:123 AND created_at:>'2024-01-01'"`, `"tag:'billing' AND status:2"`.
update_ticket
Updates an existing ticket's properties such as status, priority, assignee, subject, tags, type, and custom fields. Only provide the fields you want to change.
list_conversations
Lists all conversations (replies, notes, forwards) on a ticket. Returns the full conversation history including public replies and private agent notes.
create_ticket
Creates a new support ticket in Freshdesk. Supports setting subject, description, requester, priority, status, assignee, tags, and custom fields. Can also create outbound email tickets to initiate customer conversations.
list_knowledge_base
Browses the knowledge base hierarchy. Lists categories, or folders within a category, or articles within a folder depending on the parameters provided.
delete_ticket
Deletes a ticket from Freshdesk. The ticket is moved to trash and can be restored from the Freshdesk UI within 30 days.
get_company
Retrieves full details of a company by its ID including domains, health score, account tier, and custom fields.
search_contacts
Searches contacts using Freshdesk's filter query language. Supports filtering by name, email, phone, company, and custom fields. Example queries: `"email:'[email protected]'"`, `"company_id:42 AND active:true"`.
list_groups
Lists all agent groups in Freshdesk. Groups are used for ticket assignment and routing.
get_contact
Retrieves a contact's full details by their ID, including email, phone, company association, tags, and custom fields.
list_contacts
Lists contacts from Freshdesk with optional filtering by email, phone, company, or state. Returns paginated results.
list_companies
Lists all companies in Freshdesk with pagination support.
get_article
Retrieves a single knowledge base article by ID, including full HTML content, SEO metadata, tags, and folder/category information.
add_ticket_reply
Sends a reply on a ticket visible to the requester. Can also add internal notes for agent-only collaboration. Use `private` to create an internal note instead of a customer-facing reply.
list_canned_responses
Lists canned responses in a Freshdesk canned response folder so agents can reuse approved reply templates.
get_account
Retrieves Freshdesk account details for the connected helpdesk, including plan and portal metadata when available.
list_sla_policies
Lists Freshdesk SLA policies. Use this to inspect support targets and escalation policies that affect ticket due dates.
delete_company
Deletes a company from Freshdesk. Use when cleaning up obsolete account records after moving contacts or test data elsewhere.
search_companies
Searches companies using Freshdesk's filter query language. Supports fields such as name, domains, custom fields, health score, and account tier.
list_products
Lists Freshdesk products configured for the helpdesk. Use product IDs when creating or routing product-specific tickets.
list_business_hours
Lists Freshdesk business-hour schedules used by SLA policies and ticket due dates.
get_helpdesk_settings
Retrieves Freshdesk helpdesk-level settings, including locale and portal behavior metadata when available.
list_fields
Lists Freshdesk field definitions for tickets, contacts, or companies. Use this before writing custom fields or validating required helpdesk fields.
delete_time_entry
Deletes a Freshdesk time entry from a ticket.
delete_contact
Soft deletes a Freshdesk contact. Use this for cleanup or removing duplicate/test requester records; hard deletion is intentionally not exposed because it is irreversible.
list_satisfaction_ratings
Lists Freshdesk satisfaction ratings across tickets, with optional created-date filters for reporting and customer support quality review.
update_time_entry
Updates a Freshdesk time entry. Use this to correct the time spent, billable flag, agent attribution, or work note on an existing ticket time log.
get_current_agent
Retrieves the currently authenticated Freshdesk agent. Use this to discover the agent ID for assignment, time entry ownership, and E2E setup.
list_canned_response_folders
Lists folders that organize Freshdesk canned responses for agent replies.
Manage customer support tickets, contacts, companies, and agents. Create, update, filter, merge, and delete support tickets with custom fields, tags, priorities, and assignments. Add replies, notes, and forward emails on ticket conversations. Manage contacts and companies with search, filter, import, and export capabilities. Maintain a knowledge base of articles organized in categories and folders. Run community discussion forums with topics and comments. Track time entries on tickets, configure SLA policies, and set up automation rules with webhook triggers. Manage canned response templates, custom objects, email mailboxes, collaboration threads, and agent groups with auto-assignment. Send outbound WhatsApp messages and handle satisfaction surveys and ratings. Support field service management with service tasks and technician scheduling.
Common questions about connecting Freshdesk to AI agents with Metorial.