Resources · n8n integration

Freshworks CRM n8n integrationAutomate Freshworks CRM with n8n.

Create, read, update or delete a record without opening the CRM. The Freshworks CRM n8n integration covers 32 operations over 8 resources: accounts, contacts, deals, appointments and notes. There is no trigger node here, so the workflow starts elsewhere and this one handles the CRM side.

Verified Trustpilot reviews · AI, automation & growth agency

Why automate

What does the Freshworks CRM n8n integration actually give you?

The Freshworks CRM node is a direct line to the Freshworks CRM API from inside an n8n workflow. It exposes 32 operations over 8 resources, and each one maps to an object a sales team already knows: an account, a contact, a deal, an appointment, a note. You pick the resource, you pick the operation, you fill in the fields the node asks for, and the record moves without anyone opening the CRM.

Three shapes of workflow come back over and over. The first is inbound capture. A form, a chat or a landing page produces a lead, the workflow runs contact.create with First Name, Last Name and Email Address, then files the company with account.create so the sales team opens a complete record instead of a bare name.

The second is pipeline hygiene. A Schedule Trigger fires every morning, deal.getAll reads a saved view, and the workflow branches from there: deals that moved get deal.update, deals that closed get a short note.create summary attached to the right record. The CRM stops being the place where people forget to write things down.

The third is reporting and hand-off. Accounts and deals leave Freshworks CRM towards Google Sheets for a pipeline view the whole company can read, a digest goes out through Gmail, and a one-line message lands in Slack when a large deal is created. Marketing tools such as ActiveCampaign sit on the same bus, fed by the contact operations.

Two things are worth knowing before you build. Freshworks CRM has no trigger node in n8n, so nothing inside the CRM can start a workflow on its own: a Schedule Trigger at a fixed interval, an n8n Webhook called by another service, or the trigger of a different tool does that job. And anything outside the catalogue operations goes through the HTTP Request node, which calls any endpoint of the tool's API while reusing the same credential through predefined authentication.

Field by field, the node is generous: 24 optional entries on a new contact, 26 on a contact update, 17 on a new account. Most of the ID-shaped fields, owner, territory, lifecycle stage, deal stage, are dropdown lists that n8n loads from your account, so you are not keeping a spreadsheet of internal identifiers on the side. An expression such as {{ $json.field }}, which reads a value from the item arriving in the node, covers the rest.

Connect

How do you connect Freshworks CRM to n8n?

  1. 01

    Generate your API key

    Authentication runs on an API key. Freshworks CRM's own API authentication documentation walks through where to generate one for the account you want n8n to act as. Nothing extra is needed on the n8n side: the node ships with n8n, on n8n Cloud and on a self-hosted instance alike, with no install step and no additional cost.

  2. 02

    Read your domain off the URL

    The credential also asks for a Domain, and it wants the subdomain only. Freshworks CRM accounts live at an address of the form subdomain.myfreshworks.com, so an account you reach at https://n8n.myfreshworks.com is entered as n8n. Copy the piece that sits before the first dot, and stop there.

  3. 03

    Save the credential once

    Open the Credentials menu in n8n, create a Freshworks CRM credential, paste the API Key and the Domain, save. A credential is set up once and reused everywhere: in the node, it shows up in a dropdown list, so there is no key to paste again for the second, fifth or tenth workflow you build on the same account.

Actions

What can the Freshworks CRM node do?

The Freshworks CRM node exposes 32 operations across 8 resources. For each one: the node as you configure it in n8n, the required fields, and our field notes.

Resources × operations matrix
ResourceCreateGetGet ManyUpdateDeleteLookupQuery
Account✓✓✓✓✓
Appointment✓✓✓✓✓
Contact✓✓✓✓✓
Deal✓✓✓✓✓
Note✓✓✓
Sales Activity✓✓
Search✓✓
Task✓✓✓✓✓

Account

5 operations
01

Create an account

account.create

What you see in n8n

Notes & use cases

Adds an account to Freshworks CRM. Only the name is mandatory, so a short web form is enough to open a clean record that the sales team can enrich later.

Key parameters

  • Name: name of the account, the one required field, usually mapped from the incoming item with an expression such as {{ $json.field }}.
  • Additional Fields: an optional collection of 17 entries, among them Website, Industry Type Name or ID, Number of Employees and Owner Name or ID, the user the account is assigned to.
Use cases
a B2B signup form opens the account first, so the contact created right after has a company to belong to.
02

Delete an account

account.delete

What you see in n8n

Notes & use cases

Removes one account from Freshworks CRM. The node works from the record identifier and not from the company name, so the id has to arrive from a lookup or from an earlier step of the workflow.

Key parameters

  • Account ID: ID of the account to delete. Take it from a previous node with {{ $json.field }} rather than typing it by hand, so the workflow stays reusable.
Use cases
a cleanup run at the end of a data migration rehearsal, where the accounts loaded for the test have to disappear before the real import.
03

Get an account

account.get

What you see in n8n

Notes & use cases

Reads a single account back out of Freshworks CRM. This is the usual way to give a workflow the context the triggering system never had, since a form or a payment webhook rarely knows who owns the account.

Key parameters

  • Account ID: ID of the account to retrieve, the only field the operation needs.
Use cases
before a renewal email goes out, the workflow pulls the account so the message can be routed to the person it is assigned to.
04

Get many accounts

account.getAll

What you see in n8n

Notes & use cases

Pulls a list of accounts, scoped by a view. Views are the saved lists configured inside Freshworks CRM, and the node asks for one before it returns anything.

Key parameters

  • View Name or ID: required. Pick the view from the list, or pass its ID with an expression.
  • Return All: switched on, n8n chains the API pages until the whole view has come back; switched off, Limit caps how many accounts the node returns.
Use cases
a weekly export of the target-accounts view into a spreadsheet the whole team can read.
05

Update an account

account.update

What you see in n8n

Notes & use cases

Changes fields on an account that already exists. Nothing is mandatory beyond the identifier, so a workflow can touch a single field and leave the rest of the record alone.

Key parameters

  • Account ID: ID of the account to update.
  • Update Fields: a collection of 18 entries, including Name, Annual Revenue, Territory Name or ID and Parent Sales Account ID, which points at the parent account of the record.
Use cases
a funding announcement picked up by a watcher workflow raises Annual Revenue and Number of Employees on the matching account.

Appointment

5 operations
06

Create an appointment

appointment.create

What you see in n8n

Notes & use cases

Books an appointment in Freshworks CRM straight from a workflow. Three fields carry the meeting: a title and two timestamps.

Key parameters

  • Title, Start Date and End Date: the title plus the timestamps that denote the start and the end of the appointment. On an all-day appointment they hold the start date and the end date.
  • Additional Fields: 9 entries, including Is All-Day, Location, Time Zone, plus Target Type and Target ID, the record the appointment is created against.
Use cases
a public booking page posts to an n8n Webhook, and the slot lands in the rep's CRM calendar.
07

Delete an appointment

appointment.delete

What you see in n8n

Notes & use cases

Drops one appointment from Freshworks CRM. Useful when the cancellation happens somewhere else than the CRM, which is what usually goes wrong with meetings booked through an external page.

Key parameters

  • Appointment ID: ID of the appointment to delete. It comes from the item that created the meeting, kept in a spreadsheet row or in a database alongside the booking reference.
Use cases
a cancellation received by webhook removes the slot in the CRM so the pipeline review does not show a meeting that will never happen.
08

Get an appointment

appointment.get

What you see in n8n

Notes & use cases

Fetches one appointment by its identifier. Handy in the middle of a workflow, when a later step needs the details of the meeting rather than just its reference.

Key parameters

  • Appointment ID: ID of the appointment to retrieve, the single field the operation requires.
Use cases
a reminder workflow reads the appointment before writing the message, so the text carries the real time and place rather than what the booking form recorded days earlier.
09

Get many appointments

appointment.getAll

What you see in n8n

Notes & use cases

Lists appointments, with two filters that make the result usable instead of overwhelming. No field is required, so the operation runs as soon as it is dropped in a workflow.

Key parameters

  • Time: upcoming or past, the filter that decides which side of today you are reading.
  • Include: pulls related data along with each appointment, either appointment_attendees, creater or targetable.
  • Return All: on, every page is chained; off, Limit caps the number of appointments returned.
Use cases
a Monday digest of upcoming meetings, one message per rep, built from a single run that reads the week ahead and drops the list where the team already works.
10

Update an appointment

appointment.update

What you see in n8n

Notes & use cases

Edits an appointment already in the calendar, from its identifier. Everything else is optional, which is what makes rescheduling cheap to automate.

Key parameters

  • Appointment ID: ID of the appointment to update.
  • Update Fields: 13 entries, including Start Date, End Date, Location, Attendees and Outcome Name or ID, the outcome of the Appointment sales activity type.
Use cases
a rep moves a call in the booking tool, the workflow pushes the two new timestamps to the CRM so both calendars tell the same story.

Contact

5 operations
11

Create a contact

contact.create

What you see in n8n

Notes & use cases

Files a new person in Freshworks CRM. Three fields are required, and they are the three a lead form collects anyway.

Key parameters

  • First Name, Last Name and Email Address: the identity of the contact, typically mapped from the form payload with {{ $json.field }}.
  • Additional Fields: 24 optional entries, among them Job Title, Mobile Number, Lifecycle Stage Name or ID, Medium and Sales Account Names or IDs, the accounts the contact belongs to.
Use cases
a demo request creates the contact with its campaign origin already filled in, so attribution survives the hand-off to sales.
12

Delete a contact

contact.delete

What you see in n8n

Notes & use cases

Erases a contact record from Freshworks CRM. The identifier is the only thing standing between the workflow and the deletion, so this one is worth guarding with an IF node upstream.

Key parameters

  • Contact ID: ID of the contact to delete, read from a lookup or carried along by the item that started the run.
Use cases
an erasure request arrives in a shared inbox, gets validated by a human, and the approved row triggers the deletion in the CRM.
13

Get a contact

contact.get

What you see in n8n

Notes & use cases

Looks up one contact and brings the record into the workflow. The step that turns an identifier into something a message or a report can actually use.

Key parameters

  • Contact ID: ID of the contact to retrieve.
Use cases
an order webhook carries only the CRM id of the buyer, so the workflow reads the contact first and then decides which sequence the person should enter.
14

Get many contacts

contact.getAll

What you see in n8n

Notes & use cases

Returns contacts in bulk. Nothing is required here, and the view is optional, which makes this the operation to reach for when you want a whole segment rather than one person.

Key parameters

  • View Name or ID: optional. Point at a saved list, or leave it empty to read more broadly.
  • Return All: on, n8n chains the API pages to the end of the list; off, Limit sets the maximum number of contacts returned.
Use cases
a nightly sync that pushes the newsletter-eligible segment towards the emailing tool.
15

Update a contact

contact.update

What you see in n8n

Notes & use cases

Rewrites fields on an existing contact. The widest update surface in the node, and the one that keeps a CRM honest between two manual reviews.

Key parameters

  • Contact ID: ID of the contact to update, the only required field.
  • Update Fields: 26 entries, including Contact Status Name or ID, Owner Name or ID, Subscription Status Name or ID, Job Title and Territory Name or ID.
Use cases
an unsubscribe recorded in the emailing tool flows back into the CRM, so a rep never calls someone who has just opted out.

Deal

5 operations
16

Create a deal

deal.create

What you see in n8n

Notes & use cases

Opens a deal in the pipeline. Two required fields, a name and an amount, and the opportunity exists where the forecast is read.

Key parameters

  • Name and Amount: the label of the deal and its value, both required.
  • Additional Fields: 14 entries, including Deal Pipeline Name or ID, Deal Stage Name or ID, Sales Account Name or ID, Currency Name or ID and Probability, a number between 0 and 100.
Use cases
a signed quote in the billing tool opens the matching deal at the right stage, with the account already attached.
17

Delete a deal

deal.delete

What you see in n8n

Notes & use cases

Takes a deal out of Freshworks CRM for good. Distinct from marking it lost, which is a stage change and belongs to the update operation.

Key parameters

  • Deal ID: ID of the deal to delete.
Use cases
a duplicate created by two people filling the same form twice is removed once a deduplication step has decided which of the two records survives, so the forecast stops counting the same opportunity twice.
18

Get a deal

deal.get

What you see in n8n

Notes & use cases

Retrieves one deal from its identifier, so the rest of the workflow can branch on what the record actually says rather than on what the trigger assumed.

Key parameters

  • Deal ID: ID of the deal to retrieve, the single required field.
Use cases
a contract signature notification carries a deal reference, the workflow reads the deal, then routes the onboarding depending on which pipeline it came from.
19

Get many deals

deal.getAll

What you see in n8n

Notes & use cases

Walks through a list of deals. This is the reporting workhorse of the node, and the one place where the pagination switch really matters.

Key parameters

  • View Name or ID: optional. A saved view narrows the read to the deals you care about.
  • Return All: on, every page of the API is chained until the list is complete; off, Limit fixes the maximum number of deals the node hands to the next step.
Use cases
a Monday pipeline snapshot copied into a spreadsheet, one row per open deal.
20

Update a deal

deal.update

What you see in n8n

Notes & use cases

Moves a deal along, or corrects it. Stage, amount and owner all live in the same optional collection, so one node can handle several kinds of change.

Key parameters

  • Deal ID: ID of the deal to update.
  • Update Fields: 16 entries, including Amount, Deal Stage Name or ID, Probability and Deal Reason Name or ID, the reason for losing the deal, which can only be set on a deal in the Lost stage.
Use cases
a proposal opened by the prospect bumps the stage and the probability automatically.

Note

3 operations
21

Create a note

note.create

What you see in n8n

Notes & use cases

Attaches a written note to a record. All three fields are required, because a note without a target has nowhere to live.

Key parameters

  • Content: the content of the note.
  • Target Type: the kind of entity the note belongs to, Contact, Deal or SalesAccount.
  • Target ID: the ID of that entity, of the type chosen just above.
Use cases
a support conversation ends, the summary lands as a note on the contact, and the next rep to call has the story without leaving the CRM.
22

Delete a note

note.delete

What you see in n8n

Notes & use cases

Deletes a note from Freshworks CRM. Small operation, real use: automated notes pile up fast, and a workflow that writes them should usually know how to take them back.

Key parameters

  • Note ID: ID of the note to delete, kept from the step that created it.
Use cases
a nightly job that wrote a status note on a deal removes it before writing the next one, so the record does not collect identical entries.
23

Update a note

note.update

What you see in n8n

Notes & use cases

Corrects a note after the fact, or moves it to another record. Three optional fields, one required identifier.

Key parameters

  • Note ID: ID of the note to update.
  • Update Fields: 3 entries, Content, Target Type and Target ID, which together let a note be rewritten or re-attached to a different entity.
Use cases
a running note on a deal is rewritten at every stage change, so the record keeps one readable history instead of ten fragments.

Sales Activity

2 operations
24

Get a sales activity

salesActivity.get

What you see in n8n

Notes & use cases

Reading one sales activity means naming it by its identifier, and the node hands that single record to the rest of the workflow.

Key parameters

  • Sales Activity ID: the ID of the sales activity to retrieve. Type it in, or pull it from the item coming into the node with an expression, the n8n syntax that reads a value from the previous step, written {{ $json.field }}. Left empty, a required field stops the node before it calls Freshworks CRM.
Use cases
a reporting workflow that already collected activity IDs earlier and now fetches each record before writing its own summary line.
25

Get many sales activities

salesActivity.getAll

What you see in n8n

Notes & use cases

The list side of the same resource. Rather than one identifier, the node brings back several sales activities in a single execution, each one as its own item for the following steps.

Key parameters

  • Return All: switched on, n8n chains the pages of the API until every sales activity has come through.
  • Limit: only read when Return All stays off, and it caps how many sales activities land in the workflow.
Use cases
building the input of a sales review, where the activity history feeds a grouping step before anything is sent out.

Task

5 operations
28

Create a task

task.create

What you see in n8n

Notes & use cases

A task is created in Freshworks CRM and attached to the record it concerns, which is why five fields are required.

Key parameters

  • Title: the title of the task.
  • Due Date: the timestamp that says when the task is due to be completed.
  • Owner Name or ID: the user the task is assigned to, chosen in the list or set with an expression.
  • Target Type: Contact, Deal or SalesAccount.
  • Target ID: the ID of that entity, whose type comes from Target Type.
  • Additional Fields: Creator Name or ID, Outcome Name or ID, Task Type ID.
Use cases
a call-back task opened on a deal as soon as a form lands, with a due date a few days ahead.
29

Delete a task

task.delete

What you see in n8n

Notes & use cases

One identifier, and the task leaves the CRM. No other field takes part, so the whole question is where that identifier comes from.

Key parameters

  • Task ID: the ID of the task to delete. Coming from a previous step, it reads as an expression like {{ $json.field }}, and a required field left empty blocks the execution.
Use cases
a cleanup workflow that reads the open tasks of a closed deal and removes the ones nobody will action, so the sales view only shows live work.
30

Get a task

task.get

What you see in n8n

Notes & use cases

Before touching a task, many workflows read it first. That single read is what this operation does: one identifier in, one task record out.

Key parameters

  • Task ID: the ID of the task to retrieve, typed in the field or resolved from the incoming item.
Use cases
an approval flow where a message posted in chat carries a task ID, and the workflow fetches the task so the notification shows its real content instead of a bare number.
31

Get many tasks

task.getAll

What you see in n8n

Notes & use cases

Filtering is what makes this list genuinely useful rather than a wall of tasks. The node returns tasks as items, and the Filters collection narrows the set before it reaches the next step.

Key parameters

  • Status, in Filters: completed, due_today, due_tomorrow, open or overdue.
  • Include, in Filters: owner, targetable or users.
  • Return All: on, n8n walks the pages until the last task; off, Limit caps the number of tasks returned.
Use cases
a morning digest of overdue tasks, grouped by owner and posted to the sales channel before the standup.
32

Update a task

task.update

What you see in n8n

Notes & use cases

Editing an existing task works on one identifier plus the fields you decide to touch. Everything you leave out of the Update Fields collection stays as it is in Freshworks CRM.

Key parameters

  • Task ID: the ID of the task to update, the only required field.
  • Update Fields: Title, Due Date, Owner Name or ID, Creator Name or ID, Outcome Name or ID, Task Type ID, Target Type and Target ID. Target Type sets the kind of entity, Target ID names it.
Use cases
pushing the due date of a task when the customer asks to postpone a meeting, without rewriting its title or its owner.
Need help

Need help automating Freshworks CRM with n8n?

A person reads every message.

FAQ

Questions that come up next

01Is the Freshworks CRM n8n integration free?
Yes, on the n8n side. The node is shipped with n8n itself, so there is nothing to install and nothing extra to pay to use it. That holds on n8n Cloud, the hosted offer run by n8n, and on a self-hosted instance under the Community Edition and its Sustainable Use licence: the same workflow behaves the same way in both places. What the CRM side costs depends on the Freshworks CRM account you already have, and that is a conversation with Freshworks, not with n8n. Building a workflow, testing it and running it every day adds no line to the n8n bill.
02What credentials do you need for the Freshworks CRM node?
An API key and a domain. The API key is generated on the Freshworks CRM side, following the tool's API authentication documentation, for the account n8n should act as. The domain is the subdomain of that account, the piece of the URL before the first dot: an account reached at n8n.myfreshworks.com is entered as n8n, not as the full address. Both go into a single credential created from the Credentials menu in n8n. Once saved, that credential appears in a dropdown list inside the node and can be reused by every workflow that talks to the same account.
03What are the limits of the Freshworks CRM node in n8n?
Two practical ones. Reading lists is paginated: Return All chains the pages of the API until everything has come back, and with it switched off, Limit fixes the maximum number of items returned. On a large base, that switch is the difference between a complete export and a partial one. The second point is the perimeter itself. The node covers 32 operations spread over 8 resources, and anything outside that list is handled by the HTTP Request node, which calls any endpoint of the tool's API and reuses the very same credential through predefined authentication.
04Can Freshworks CRM trigger an n8n workflow in real time?
No, because the tool has no trigger node in n8n. A workflow that touches Freshworks CRM starts somewhere else: a Schedule Trigger that runs at a fixed interval, an n8n Webhook called by a third-party service, or the trigger of another tool already in the stack. In practice that covers most needs. A form that posts to a Webhook creates the contact in the second that follows, and a Schedule Trigger reading a deal view every morning is enough for reporting, alerting and pipeline hygiene, none of which need to react within a second.
05n8n or Make for Freshworks CRM?
It comes down to four criteria, and neither tool wins them all. Hosting: n8n runs on your own server or on n8n Cloud, Make is hosted only. Data control: with a self-hosted n8n, the CRM records stay on infrastructure you own, which matters when contact data is sensitive. Cost model: Make is billed per operation, which is easy to forecast and grows with volume, while a self-hosted n8n trades that for a server to maintain. Visual logic: both draw the workflow on a canvas, and the choice there is mostly a matter of habit.