Skip to main content
Freshdesk logo

Overview

Add Freshdesk to any ModuleX agent or workflow. Customer support helpdesk platform for managing tickets, contacts, agents, and knowledge base articles via the Freshdesk REST API ({domain}.freshdesk.com/api/v2).
Categories: Customer Support · Helpdesk · Productivity & Collaboration · Auth: API Key · Actions: 45

Authentication

API Key Authentication

Authenticate using your Freshdesk API key and subdomain
1

Step 1

Log in to your Freshdesk account
2

Step 2

Click your profile picture in the top right corner
3

Step 3

Go to Profile Settings
4

Step 4

Your API key is displayed on the right side of the page

Required Credentials

Available Actions

Parameters

string
required
Subject of the ticket
string
required
HTML content of the ticket
string
required
Email address of the requester
integer
Priority of the ticket: 1 (Low), 2 (Medium), 3 (High), 4 (Urgent) (Default: 1)
integer
Status of the ticket: 2 (Open), 3 (Pending), 4 (Resolved), 5 (Closed) (Default: 2)
integer
ID of the company to associate with the ticket

Response

Parameters

integer
required
ID of the ticket to retrieve

Response

Parameters

integer
required
ID of the ticket to update
string
New subject for the ticket
string
New HTML content for the ticket
integer
Priority: 1 (Low), 2 (Medium), 3 (High), 4 (Urgent)
integer
Status: 2 (Open), 3 (Pending), 4 (Resolved), 5 (Closed)
integer
ID of the group to assign the ticket to
integer
ID of the agent to assign the ticket to

Response

Parameters

string
Predefined filter: new_and_my_open, watching, spam, deleted, all_tickets
integer
Filter tickets by requester ID
string
Filter tickets by requester email
integer
Filter tickets by company ID
integer
Maximum number of results to return (Default: 100)

Response

Parameters

integer
required
ID of the ticket to close

Response

Parameters

integer
required
ID of the ticket to add a note to
string
required
Content of the note in HTML format
boolean
Whether the note is private (true) or public (false) (Default: true)
array
List of email addresses to notify about this note

Response

Parameters

integer
required
ID of the ticket
array
required
List of tag names to add to the ticket

Response

Parameters

integer
required
ID of the ticket
array
required
List of tag names to remove from the ticket

Response

Parameters

integer
required
ID of the ticket
array
required
List of tag names to set on the ticket (replaces existing tags)

Response

Parameters

integer
required
ID of the ticket
integer
required
Priority: 1 (Low), 2 (Medium), 3 (High), 4 (Urgent)

Response

Parameters

integer
required
ID of the ticket
integer
required
Status: 2 (Open), 3 (Pending), 4 (Resolved), 5 (Closed)

Response

Parameters

integer
required
ID of the ticket
integer
required
ID of the agent to assign the ticket to

Response

Parameters

integer
required
ID of the ticket
integer
required
ID of the group to assign the ticket to

Response

Parameters

string
required
Email address of the contact
string
required
Name of the contact
string
Phone number of the contact
integer
ID of the company to associate with the contact

Response

Parameters

integer
required
ID of the contact to retrieve

Response

Parameters

integer
required
ID of the contact to update
string
Updated name of the contact
string
Updated email address
string
Updated phone number
integer
ID of the company to associate with the contact

Response

Parameters

string
required
Name of the company
array
List of domain names associated with the company (e.g. [‘example.com’])
string
Description of the company

Response

Parameters

string
required
Email address of the agent
integer
required
Ticket permission: 1 (Global Access), 2 (Group Access), 3 (Restricted Access)
boolean
Set to true if this is an occasional agent
integer
Type: 1 (Support Agent), 2 (Field Agent), 3 (Collaborator)

Response

Parameters

integer
required
ID of the agent to update
string
Updated email address
integer
Ticket permission: 1 (Global Access), 2 (Group Access), 3 (Restricted Access)
boolean
Set to true if this is an occasional agent

Response

Parameters

integer
required
ID of the agent to retrieve

Response

Parameters

string
Filter agents by email address
string
Filter by state: fulltime, occasional
integer
Maximum number of results to return (Default: 100)

Response

Parameters

integer
required
ID of the ticket to reply to
string
required
Content of the reply in HTML format
array
List of email addresses to CC
array
List of email addresses to BCC

Response

Parameters

integer
required
ID of the ticket to forward
string
required
Content of the forward in HTML format
array
required
List of email addresses to forward to
array
List of email addresses to CC
array
List of email addresses to BCC

Response

Parameters

integer
required
ID of the ticket
string
required
Content of the reply in HTML format
array
required
List of email addresses to reply to

Response

Parameters

integer
required
ID of the ticket to create the thread for
string
required
Type of thread: forward, discussion
integer
required
ID of the email config to use for the thread

Response

Parameters

integer
required
ID of the ticket
string
required
ID of the thread to post the message in
string
required
Content of the message in HTML format
string
Subject of the email

Response

Parameters

integer
required
ID of the ticket
integer
Maximum number of results to return (Default: 100)

Response

Parameters

integer
Maximum number of results to return (Default: 100)

Response

Parameters

string
required
Display name of the ticket field
string
required
Label for the field as seen by customers
string
required
Field type: custom_dropdown, custom_checkbox, custom_text, custom_paragraph, custom_number, custom_date, custom_decimal, custom_url

Response

Parameters

string
required
ID of the ticket field to update
string
Updated display name
string
Updated label for customers

Response

Parameters

integer
required
ID of the folder to create the article in
string
required
Title of the article
string
required
HTML content of the article
integer
required
Status: 1 (Draft), 2 (Published)
array
List of tags for the article

Response

Parameters

integer
required
ID of the article to retrieve

Response

Parameters

integer
required
ID of the article to update
string
Updated title
string
Updated HTML content
integer
Status: 1 (Draft), 2 (Published)
array
Updated tags for the article

Response

Parameters

integer
required
ID of the article to delete

Response

Parameters

string
required
Search keyword to find matching articles

Response

Response

Parameters

integer
required
ID of the solution category

Response

Parameters

integer
required
ID of the solution folder
integer
Maximum number of results to return (Default: 100)

Response

Parameters

integer
Maximum number of results to return (Default: 100)

Response

Parameters

integer
required
ID of the canned response folder

Response

Parameters

integer
required
ID of the canned response

Response

Parameters

integer
required
ID of the canned response folder
integer
Maximum number of results to return (Default: 100)

Response

Response

Response

Response

Limits & Quotas

  • Rate limits: Freshdesk applies per-plan rate limits. Free plans: 50 calls/min. Growth and above: 200-400+ calls/min depending on plan.
  • Pagination: List endpoints return up to 100 results per page by default.
  • Error model: non-2xx responses are caught and returned as success=False + error rather than raising.

Cal.com

Canva

ConvertAPI