KosmoKrator

productivity

Freshdesk CLI for Headless Automation

Use the Freshdesk CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

15 functions 9 read 6 write API key auth
Submit Freshdesk feedback View package source

Freshdesk CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The Freshdesk CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Freshdesk CLI for Headless Automation
kosmokrator integrations:configure freshdesk --set api_key="$FRESHDESK_API_KEY" --set domain="$FRESHDESK_DOMAIN" --enable --read allow --write ask --json
kosmo integrations:call freshdesk.freshdesk_list_tickets '{"page":1,"per_page":1,"filter":"example_filter","company_id":1,"requester_id":1,"email":"example_email"}' --json

Discovery Before Execution

Agents and scripts can inspect Freshdesk docs and schemas before choosing a function.

kosmo integrations:docs freshdesk --json
kosmo integrations:docs freshdesk.freshdesk_list_tickets --json
kosmo integrations:schema freshdesk.freshdesk_list_tickets --json
kosmo integrations:search "Freshdesk" --json
kosmo integrations:list --json

Useful Freshdesk CLI Functions

FunctionTypeParametersDescription
freshdesk.freshdesk_list_tickets Read page, per_page, filter, company_id, requester_id, email List support tickets from Freshdesk. Supports filtering by status, priority, and pagination. Returns ticket details including subject, status, priority, requester, and assignee.
freshdesk.freshdesk_get_ticket Read ticket_id Get full details of a specific support ticket including description, custom fields, conversation history, and associated contacts.
freshdesk.freshdesk_create_ticket Write subject, description, email, priority, status, type, tags, group_id, assignee_id, cc_emails Create a new support ticket. Requires a subject, description, and requester email. Optionally set priority and status.
freshdesk.freshdesk_update_ticket Write ticket_id, subject, description, priority, status, type, tags, group_id, assignee_id Update an existing support ticket. Can change subject, description, status, priority, assignee, and other fields.
freshdesk.freshdesk_delete_ticket Write ticket_id Permanently delete a support ticket. This action cannot be undone.
freshdesk.freshdesk_list_contacts Read page, per_page, email, company_id, mobile, phone List customer contacts from Freshdesk. Supports pagination. Returns contact names, emails, and company associations.
freshdesk.freshdesk_get_contact Read contact_id Get full details of a specific customer contact including email, phone, company, and custom fields.
freshdesk.freshdesk_create_contact Write email, name, phone, mobile, company_id, job_title, tags Create a new customer contact in Freshdesk. Requires an email address and name.
freshdesk.freshdesk_list_agents Read page, per_page List all helpdesk agents. Returns agent details including name, email, availability, and group memberships.
freshdesk.freshdesk_get_agent Read agent_id Get details of a specific helpdesk agent including name, email, role, availability, and group assignments.
freshdesk.freshdesk_list_conversations Read ticket_id List all conversations on a ticket — includes public replies and private notes. Shows who posted, the body, and timestamps.
freshdesk.freshdesk_create_reply Write ticket_id, body, cc_emails, bcc_emails Post a public reply to a support ticket. The reply is visible to the requester. Use this to respond to customers.
freshdesk.freshdesk_create_note Write ticket_id, body Add a private note to a support ticket. Notes are only visible to agents, not to the customer. Use for internal communication.
freshdesk.freshdesk_list_companies Read page, per_page List customer companies from Freshdesk. Supports pagination. Returns company names, domains, and associated contacts.
freshdesk.freshdesk_get_current_user Read none Get the currently authenticated Freshdesk agent. Returns agent name, email, role, and availability. Use this to verify API credentials are working.

Automation Notes

Related Freshdesk CLI Pages

CI Freshdesk CLI for CI. Cron Jobs Freshdesk CLI for cron jobs. Shell Scripts Freshdesk CLI for shell scripts. Coding Agents Freshdesk CLI for coding agents.