Freshsales

AI-powered CRM for managing contacts, leads, accounts, and deals.

Detail	Value
Category	CRM
Base URL	https://{domain}.freshsales.io/api
Authentication	Bearer Token
Endpoints	6
Connector key	freshsales

Using Freshsales in a workflow

1. Go to Connections and click New Connection.
2. Pick Freshsales from the marketplace.
3. Enter your credentials (see Authentication above for what's expected).
4. In a workflow, drop an API Call node and select this connection.
5. Pick the operation you need from the Operation dropdown. The full list is below.

Available endpoints

Endpoint	Summary
GET /contacts	List contacts
POST /contacts	Create a contact
GET /contacts/{id}	Get a contact
GET /leads	List leads
POST /leads	Create a lead
GET /deals	List deals

Each endpoint is documented in full below. Use the outline on the right to jump to one.

GET /contacts

List contacts

Detail	Value
Operation ID	crm.listContacts
Method	GET
Path	/contacts

Parameters

Name	Location	Type	Required
page	query	integer	No

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Freshsales connection from the Connection dropdown.
3. In the Operation dropdown, select crm.listContacts.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Freshsales API reference.

POST /contacts

Create a contact

Detail	Value
Operation ID	crm.createContact
Method	POST
Path	/contacts

Parameters

No parameters.

Request Body

Field	Type
first_name	string
last_name	string
email	string

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Freshsales connection from the Connection dropdown.
3. In the Operation dropdown, select crm.createContact.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Freshsales API reference.

GET /contacts/{id}

Get a contact

Detail	Value
Operation ID	crm.getContact
Method	GET
Path	/contacts/{id}

Parameters

Name	Location	Type	Required
id	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Freshsales connection from the Connection dropdown.
3. In the Operation dropdown, select crm.getContact.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Freshsales API reference.

GET /leads

List leads

Detail	Value
Operation ID	crm.listLeads
Method	GET
Path	/leads

Parameters

Name	Location	Type	Required
page	query	integer	No

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Freshsales connection from the Connection dropdown.
3. In the Operation dropdown, select crm.listLeads.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Freshsales API reference.

POST /leads

Create a lead

Detail	Value
Operation ID	crm.createLead
Method	POST
Path	/leads

Parameters

No parameters.

Request Body

Field	Type
first_name	string
last_name	string
email	string

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Freshsales connection from the Connection dropdown.
3. In the Operation dropdown, select crm.createLead.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Freshsales API reference.

GET /deals

List deals

Detail	Value
Operation ID	crm.listDeals
Method	GET
Path	/deals

Parameters

No parameters.

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Freshsales connection from the Connection dropdown.
3. In the Operation dropdown, select crm.listDeals.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Freshsales API reference.