Freshsales
Freshsales API
Checked on 2026-10-10 in the developer documentation.
How to use Freshsales
This guide gets you to a working Freshsales setup that actually moves deals, not a CRM you log into once and abandon. It is for founders and small B2B sales teams who want a clean pipeline, AI scoring that earns its keep, and built-in email and phone without bolting on five extra tools. If you are coming from a spreadsheet or from a heavyweight CRM that drowned you in admin, this is the path I would take.
Getting set up
Start with the model, not the screens. Freshsales runs on the classic CRM shapes: contacts, accounts, deals, and the activities that connect them. Before you import anything, decide what a "deal" means for your business and what stages a deal genuinely passes through. Most teams invent too many stages and then half of them sit empty. I would rather see five stages that every deal really moves through than twelve that exist for show.
The decisions that matter early:
Pick your pipeline stages to match your actual sales motion, and name them after what the buyer does, not what you do internally. "Demo booked" beats "stage 2". If you sell more than one way (inbound versus outbound, or two product lines), use separate pipelines rather than cramming everything into one.
Read the full guideShow less
Define your custom fields before you import. Freshsales lets you add fields to contacts, accounts, and deals, and it is far cleaner to map your spreadsheet columns into fields that already exist than to retro-fit them later. Keep the field list lean: every field you add is a field someone has to fill in.
Set up email sync and a connected mailbox early, because the whole value of Freshsales is that it captures conversations automatically. Connect the inbox you actually sell from, decide whether you want two-way sync, and confirm that logged emails attach to the right contact and deal.
Get your team and territories right before the data lands. Decide who owns what, set up assignment so new leads route to a real person, and only then import. Importing into an empty owner column is how leads quietly go cold.
How to actually use it
Work it in this order, because each step feeds the next.
First, get every contact and account in cleanly, deduplicated, with an owner. A CRM with duplicate records is a CRM nobody trusts.
Second, create deals and put them on the pipeline. The deal is the unit of work in Freshsales, and the pipeline view is where you should spend most of your time. Drag deals between stages as they progress, and keep the expected close date and value honest, because the forecasting and reporting are only as good as those two fields.
Third, live in the activity timeline. Log calls, send and track email from inside the record, and set a follow-up task every single time you touch a deal. The discipline that makes any CRM pay off is simple: no deal leaves your hands without a next action booked. Freshsales makes that easy with built-in email, the phone, and tasks all on the same record.
Fourth, use the built-in email sequences for the repeatable follow-ups. Instead of remembering to chase someone four times, set the cadence once and let it run, then step in the moment they reply.
Fifth, read your pipeline weekly. Sort by stage, by close date, and by deals with no recent activity. That last filter, deals that have gone quiet, is the most useful report you will run, and it is where most revenue leaks out.
Power moves
Lean on Freddy, the built-in AI, but treat it as a prompt, not a verdict. The contact and deal scoring is genuinely useful for telling you where to spend the next hour, and the predicted-close signals are worth a glance, but you still qualify with your own judgement. Use the score to sort your day, not to make your decisions.
Build workflows for the things you keep doing by hand. Auto-assign new leads, auto-create a follow-up task when a deal hits a stage, notify an owner when a high-value deal goes stale. Each automation you set up is a piece of admin you never do again.
Use sales sequences with branching so a reply or a click changes what happens next, rather than blasting the same chase to everyone. A sequence that reacts to behaviour feels like a person; one that does not feels like spam.
Make custom views your home screen. Save filtered views like "my deals closing this month" or "accounts with no activity in 30 days" and pin them, so the CRM opens on the work that matters instead of a generic list.
Wire your web forms straight into Freshsales so inbound leads land as contacts with the source attached, scored and assigned the moment they arrive. The faster a lead becomes a real record with an owner, the faster someone follows up.
Where it fits your stack
Freshsales sits at the centre as your system of record for the sales side. Connect your real selling mailbox (Google or Microsoft) so email lives on the record automatically, and use the built-in phone so calls are logged without a separate dialler. That two-in-one is a big part of why teams pick it.
For everything else, connect through native integrations or a connector like Zapier or Make: push form fills in from your website and landing pages, sync won deals into your billing or invoicing tool, and pass closed-won contacts to your onboarding or support system so nothing is re-typed. If you run marketing in a separate tool, decide clearly which system owns the contact so the two do not fight over the same record. Inside the Freshworks family, the tie-in with their support and marketing products is the cleanest, so if you are already on one of those, that is the path of least friction.
Pitfalls to avoid
The biggest mistake is over-building at the start: too many stages, too many fields, too many pipelines, all of it empty. Start lean and add only when a real gap appears.
The second is trusting the AI score blindly. Freddy is a strong signal, not a sales manager. Sort by it, then think.
The third is letting data rot. Duplicates, owner-less leads, and deals with stale close dates quietly destroy every report you run, so build the dedupe and assignment rules in before the first import, not after.
The fourth is treating Freshsales as a log instead of a workflow. If you only update it after the fact, it is a diary. The value comes from working inside it: next action booked every time, sequences running, the pipeline as your daily screen.
How to automate Freshsales
Native integrations
Freshsales connects to the rest of Freshworks, including Freshdesk, so a rep can see a customer's support tickets next to the deal. Other apps come through the Freshworks Marketplace. One concrete idea: when a customer has an open urgent ticket, show it on the deal, so the rep does not send a sales email in the middle of an outage.
API and webhooks
Freshsales has a documented REST API at developers.freshworks.com with endpoints for contacts, accounts, deals, and bulk upsert. One concrete idea: when a new lead fills in a form on your site, your system upserts the contact in Freshsales and assigns it to the right owner.
MCP server
There is no official MCP server for Freshsales data yet. Freshworks has a Developer MCP server, but it is for building and publishing marketplace apps, not for reading CRM records. For assistant access, use the API with care, and limit the permissions of the key.