The Freshsales connector lets your AI agent act in each user's Freshsales account. Each user connects their own Freshsales API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 30 tools.
- Tools
- 30
- What they doRead · write · destructive
- 17 · 13 · 017 read13 write0 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Freshsales connection
In AgentKit > Connections, create a Freshsales connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'freshsales'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Freshsales:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'freshsales_appointments_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "freshsales"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Freshsales:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="freshsales_appointments_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Freshsales credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolfreshsales_appointment_getGet one Freshsales appointment by ID.Read-onlyGet Appointment
Get one Freshsales appointment by ID. Returns the appointment's title, start and end, time zone, location, linked record and attendees. Use this when you have an appointment ID. Use freshsales_appointments_list to find appointments.
Inputs
appointment_idintegerrequired- Numeric ID of the appointment. Get it from freshsales_appointments_list. Example: 16000123456.
freshsales_appointments_listList Freshsales appointments, either upcoming or past.Read-onlyList Appointments
List Freshsales appointments, either upcoming or past. Returns the appointments with id, title, start and end, and time zone. Use this to review a calendar. Use freshsales_appointment_get for one appointment's full details.
Inputs
filterstring- Which appointments to return. Use open for upcoming appointments (the default). Freshsales documents the other value as complete (past appointments). Example: open.default
open includestring- Comma-separated related records to embed in the appointments response. Allowed values: creater, targetable, appointment_attendees. Example: targetable,appointment_attendees.
pageinteger- Page number to return, starting at 1. Each page holds 25 records by default. Example: 2.
freshsales_contact_getGet one Freshsales contact by ID.Read-onlyGet Contact
Get one Freshsales contact by ID. Returns the contact's fields, emails, custom fields and any related records requested in include. Use this when you have a contact ID. Use freshsales_search or freshsales_lookup to find one by name or email.
Inputs
contact_idintegerrequired- Numeric ID of the contact. Get it from freshsales_search or freshsales_contacts_list. Example: 16000123456.
includestring- Comma-separated related records to embed in the contact response. Allowed values: sales_accounts, owner, creater, updater, source, campaign, tasks, appointments, notes, deals, territory, sales_activities. Example: sales_accounts,owner.
freshsales_contacts_listList the contacts in a Freshsales view, one page at a time.Read-onlyList Contacts
List the contacts in a Freshsales view, one page at a time. Returns up to 25 contacts per page with id, name, email, phone and lead score, plus meta.total. Use this to browse contacts. Use freshsales_search to find contacts by text. Get a view_id from freshsales_views_list (entity contacts) first.
Inputs
view_idintegerrequired- Numeric ID of the view. Get it from freshsales_views_list with entity contacts. Example: 16000001234.
pageinteger- Page number to return, starting at 1. Each page holds 25 records by default. Example: 2.
sortstring- Field to sort the contacts by. One of: lead_score, created_at, updated_at, open_deals_amount, last_contacted. Example: updated_at.one of
lead_scorecreated_atupdated_atopen_deals_amountlast_contacted sort_typestring- Sort direction: asc for ascending or desc for descending. Example: desc.one of
ascdesc
freshsales_deal_getGet one Freshsales deal by ID.Read-onlyGet Deal
Get one Freshsales deal by ID. Returns the deal's amount, stage, expected close date, custom fields and any related records requested in include. Use this when you have a deal ID. Use freshsales_search to find one by name.
Inputs
deal_idintegerrequired- Numeric ID of the deal. Get it from freshsales_search or freshsales_deals_list. Example: 16000123456.
includestring- Comma-separated related records to embed in the deal response. Allowed values: sales_account, owner, creater, updater, source, contacts, deal_stage, deal_reason, deal_type, campaign, deal_payment_status, deal_product, currency, sales_activities. Example: sales_account,deal_stage,contacts.
freshsales_deals_listList the deals in a Freshsales view, one page at a time.Read-onlyList Deals
List the deals in a Freshsales view, one page at a time. Returns up to 25 deals per page with id, name, amount, stage and expected close date, plus meta.total. Use this to browse a pipeline. Use freshsales_search to find deals by name. Get a view_id from freshsales_views_list (entity deals) first.
Inputs
view_idintegerrequired- Numeric ID of the view. Get it from freshsales_views_list with entity deals. Example: 16000001234.
pageinteger- Page number to return, starting at 1. Each page holds 25 records by default. Example: 2.
sortstring- Field to sort the deals by. One of: amount, expected_close, created_at, updated_at, last_contacted. Example: updated_at.one of
amountexpected_closecreated_atupdated_atlast_contacted sort_typestring- Sort direction: asc for ascending or desc for descending. Example: desc.one of
ascdesc
freshsales_lookupFind Freshsales contacts, accounts or deals whose field exactly equals a value, such as an email address or name.Read-onlyLookup Records
Find Freshsales contacts, accounts or deals whose field exactly equals a value, such as an email address or name. Returns the matching records grouped by record type. Use this to check whether a record exists before creating one. Use freshsales_search for partial or free-text matches.
Inputs
entitiesstringrequired- Comma-separated record types to look in: contact, sales_account, deal. Every listed type must have the field in f. Example: contact.
fstringrequired- Field to match against. Contacts support name, email and text, number, dropdown or radio custom fields (by internal name, e.g. cf_region); accounts and deals support name and the same custom field types. Example: email.
qstringrequired- Exact value to match. Partial values do not match. Example: jane@acme.com.
freshsales_owners_listList the users in the Freshsales account who can own records.Read-onlyList Owners
List the users in the Freshsales account who can own records. Returns each user's id and display name. Use this to find the owner_id to assign contacts, accounts, deals, tasks and sales activities.
Inputs
This tool takes no inputs.
freshsales_sales_account_getGet one Freshsales account (company) by ID.Read-onlyGet Account
Get one Freshsales account (company) by ID. Returns the account's fields, custom fields and any related records requested in include, such as its contacts and deals. Use this when you have an account ID. Use freshsales_search to find one by name.
Inputs
sales_account_idintegerrequired- Numeric ID of the account. Get it from freshsales_search or freshsales_sales_accounts_list. Example: 16000123456.
includestring- Comma-separated related records to embed in the account response. Allowed values: owner, creater, updater, territory, business_type, tasks, appointments, contacts, deals, industry_type, child_sales_accounts. Example: contacts,deals.
freshsales_sales_accounts_listList the accounts (companies) in a Freshsales view, one page at a time.Read-onlyList Accounts
List the accounts (companies) in a Freshsales view, one page at a time. Returns up to 25 accounts per page with id, name, website and open deal amount, plus meta.total. Use this to browse accounts. Use freshsales_search to find accounts by name. Get a view_id from freshsales_views_list (entity sales_accounts) first.
Inputs
view_idintegerrequired- Numeric ID of the view. Get it from freshsales_views_list with entity sales_accounts. Example: 16000001234.
pageinteger- Page number to return, starting at 1. Each page holds 25 records by default. Example: 2.
sortstring- Field to sort the accounts by. One of: open_deals_amount, created_at, updated_at, last_contacted. Example: updated_at.one of
open_deals_amountcreated_atupdated_atlast_contacted sort_typestring- Sort direction: asc for ascending or desc for descending. Example: desc.one of
ascdesc
freshsales_sales_activities_listList the sales activities in the Freshsales account, one page at a time.Read-onlyList Sales Activities
List the sales activities in the Freshsales account, one page at a time. Returns activities with id, title, type, outcome, start and end, owner and linked record, plus pagination meta. Use this to review logged activity. Use freshsales_sales_activity_get for one activity.
Inputs
pageinteger- Page number to return, starting at 1. Each page holds 25 records by default. Example: 2.
per_pageinteger- Number of activities per page. Example: 25.
freshsales_sales_activity_getGet one Freshsales sales activity by ID.Read-onlyGet Sales Activity
Get one Freshsales sales activity by ID. Returns the activity's title, type, outcome, start and end, notes, owner and linked record. Use this when you have an activity ID. Use freshsales_sales_activities_list to browse activities.
Inputs
sales_activity_idintegerrequired- Numeric ID of the sales activity. Get it from freshsales_sales_activities_list. Example: 16000123456.
freshsales_searchSearch Freshsales contacts, accounts, deals and users by name or email text.Read-onlySearch Records
Search Freshsales contacts, accounts, deals and users by name or email text. Returns matching records with id, name, type and (for contacts and users) email; partial matches are included. Use this for a free-text search. Use freshsales_lookup for an exact match on one field, such as an email address.
Inputs
includestringrequired- Comma-separated record types to search: contact, sales_account, deal, user. Freshsales returns nothing when this is empty. Example: contact,sales_account.
qstringrequired- Text to search for in record names and email addresses. Example: acme.
per_pageinteger- Maximum number of results to return, up to 100. Defaults to 10. Example: 25.
freshsales_selector_options_listList the allowed values for a Freshsales configuration field, such as deal stages, lead sources or sales activity types.Read-onlyList Selector Options
List the allowed values for a Freshsales configuration field, such as deal stages, lead sources or sales activity types. Returns each option's id and name (deal stages also include deal_pipeline_id). Use this to find the ID to pass in fields like deal_stage_id, lead_source_id or sales_activity_type_id. Use freshsales_owners_list for users.
Inputs
selectorstringrequired- Which configuration list to return. Example: deal_stages returns the stages of the default pipeline; sales_activity_types returns the activity types used by sales activities.one of
ownersterritoriesdeal_stagescurrenciesdeal_reasonsdeal_typeslead_sourcesindustry_typesbusiness_typescampaignsdeal_payment_statusesdeal_productsdeal_pipelinescontact_statusessales_activity_typessales_activity_outcomessales_activity_entity_typeslifecycle_stagesdesignations
freshsales_task_getGet one Freshsales task by ID.Read-onlyGet Task
Get one Freshsales task by ID. Returns the task's title, description, due date, status, owner ID and any related records requested in include. Use this when you have a task ID. Use freshsales_tasks_list to find tasks.
Inputs
task_idintegerrequired- Numeric ID of the task. Get it from freshsales_tasks_list or a contact's tasks. Example: 16000123456.
includestring- Comma-separated related records to embed in the task response. Allowed values: users (the task's collaborators) and targetable (the linked contact, account or deal). Example: users,targetable.
freshsales_tasks_listList Freshsales tasks matching one status filter: open, due today, due tomorrow, overdue or completed.Read-onlyList Tasks
List Freshsales tasks matching one status filter: open, due today, due tomorrow, overdue or completed. Returns the tasks with id, title, due date, status and owner. Use this to review a to-do list. Use freshsales_task_get for one task's full details.
Inputs
filterstringrequired- Which tasks to return: open, due_today, due_tomorrow, overdue or completed. Only one filter per call. Example: open.one of
opendue_todaydue_tomorrowoverduecompleted includestring- Comma-separated related records to embed in the tasks response. Allowed values: users, targetable, owner. Example: targetable,owner.
pageinteger- Page number to return, starting at 1. Each page holds 25 records by default. Example: 2.
freshsales_views_listList the saved views (filters) for contacts, accounts or deals in Freshsales.Read-onlyList Views
List the saved views (filters) for contacts, accounts or deals in Freshsales. Returns each view's id and name. Use this first to get a view_id for freshsales_contacts_list, freshsales_sales_accounts_list or freshsales_deals_list.
Inputs
entitystringrequired- Record type to list views for: contacts, sales_accounts (accounts) or deals. Example: contacts.one of
contactssales_accountsdeals
freshsales_appointment_createSchedule an appointment (meeting) in Freshsales, optionally linked to a contact, account or deal and with attendees.WriteCreate Appointment
Schedule an appointment (meeting) in Freshsales, optionally linked to a contact, account or deal and with attendees. Returns the new appointment with its id. Use freshsales_appointment_update to reschedule an existing appointment.
Inputs
end_datestringrequired- End of the appointment as an ISO 8601 datetime (or a date for an all-day appointment). Example: 2026-11-20T15:30:00Z.
from_datestringrequired- Start of the appointment as an ISO 8601 datetime (or a date for an all-day appointment). Example: 2026-11-20T15:00:00Z.
titlestringrequired- Title of the appointment. Example: Product demo with Acme.
attendee_contact_idsarray- IDs of contacts to invite. Example: [16000123456].
attendee_user_idsarray- IDs of Freshsales users to invite. Get user IDs from freshsales_owners_list. Example: [16000012345].
descriptionstring- Agenda or details of the appointment. Example: Walk through the reporting module.
is_alldayboolean- Set to true for an all-day appointment; then from_date and end_date are dates. Example: false.
locationstring- Where the appointment takes place. Example: Zoom.
outcome_idinteger- ID of the outcome. Get valid IDs from freshsales_selector_options_list with selector sales_activity_outcomes. Example: 16000000123.
targetable_idinteger- ID of the contact, account or deal the appointment is linked to, matching targetable_type. Example: 16000123456.
targetable_typestring- Type of record the appointment is linked to: Contact, SalesAccount (an account) or Deal. Example: Contact.one of
ContactSalesAccountDeal time_zonestring- Time zone the appointment is scheduled in, as a Rails time zone name. Example: Pacific Time (US & Canada).
freshsales_appointment_updateUpdate an existing Freshsales appointment, for example to reschedule it or change attendees.WriteUpdate Appointment
Update an existing Freshsales appointment, for example to reschedule it or change attendees. Returns the updated appointment. Only the fields you pass are changed. Use freshsales_appointment_create to schedule a new appointment.
- Idempotent
Inputs
appointment_idintegerrequired- Numeric ID of the appointment. Get it from freshsales_appointments_list. Example: 16000123456.
attendee_contact_idsarray- IDs of contacts to invite. Example: [16000123456].
attendee_user_idsarray- IDs of Freshsales users to invite. Get user IDs from freshsales_owners_list. Example: [16000012345].
descriptionstring- Agenda or details of the appointment. Example: Walk through the reporting module.
end_datestring- End of the appointment as an ISO 8601 datetime (or a date for an all-day appointment). Example: 2026-11-20T15:30:00Z.
from_datestring- Start of the appointment as an ISO 8601 datetime (or a date for an all-day appointment). Example: 2026-11-20T15:00:00Z.
is_alldayboolean- Set to true for an all-day appointment; then from_date and end_date are dates. Example: false.
locationstring- Where the appointment takes place. Example: Zoom.
outcome_idinteger- ID of the outcome. Get valid IDs from freshsales_selector_options_list with selector sales_activity_outcomes. Example: 16000000123.
targetable_idinteger- ID of the contact, account or deal the appointment is linked to, matching targetable_type. Example: 16000123456.
targetable_typestring- Type of record the appointment is linked to: Contact, SalesAccount (an account) or Deal. Example: Contact.one of
ContactSalesAccountDeal time_zonestring- Time zone the appointment is scheduled in, as a Rails time zone name. Example: Pacific Time (US & Canada).
titlestring- Title of the appointment. Example: Product demo with Acme.
freshsales_contact_createCreate a contact (a person) in Freshsales.WriteCreate Contact
Create a contact (a person) in Freshsales. Returns the new contact with its id. Use freshsales_lookup first to avoid duplicates. Use freshsales_contact_update to change an existing contact.
Inputs
addressstring- Street address. Example: 100 Market St.
citystring- City. Example: San Francisco.
contact_status_idinteger- ID of the contact status. Get valid IDs from freshsales_selector_options_list with selector contact_statuses. Example: 16000000123.
countrystring- Country. Example: USA.
custom_fieldobject- Custom field values for the contact, keyed by the field's internal name (which starts with cf_). Example: {"cf_is_active": true, "cf_region": "EMEA"}.
emailstring- Primary email address of the contact. A contact needs at least one of email, mobile_number or twitter. Example: jane@acme.com.
first_namestring- First name of the contact. Example: Jane.
job_titlestring- Job title of the contact. Example: VP Sales.
last_namestring- Last name of the contact. Example: Sampleton.
lead_source_idinteger- ID of the lead source. Get valid IDs from freshsales_selector_options_list with selector lead_sources. Example: 16000000123.
lifecycle_stage_idinteger- ID of the lifecycle stage. Get valid IDs from freshsales_selector_options_list with selector lifecycle_stages. Example: 16000000123.
mobile_numberstring- Mobile phone number; must be unique across contacts. Example: +1-415-555-0199.
owner_idinteger- ID of the Freshsales user who owns the contact. Get user IDs from freshsales_owners_list. Example: 16000012345.
sales_accountsarray- Accounts to link the contact to. Each item has the account id and is_primary (true for exactly one). Example: [{"id": 16000045678, "is_primary": true}].
statestring- State or region. Example: California.
territory_idinteger- ID of the territory. Get valid IDs from freshsales_selector_options_list with selector territories. Example: 16000000123.
twitterstring- Twitter username of the contact, without @. Example: janesampleton.
work_numberstring- Work phone number. Example: +1-415-555-0100.
zipcodestring- Postal code. Example: 94105.
freshsales_contact_updateUpdate fields on an existing Freshsales contact.WriteUpdate Contact
Update fields on an existing Freshsales contact. Returns the updated contact. Only the fields you pass are changed. Use freshsales_contact_create to add a new contact.
- Idempotent
Inputs
contact_idintegerrequired- Numeric ID of the contact. Get it from freshsales_search or freshsales_contacts_list. Example: 16000123456.
addressstring- Street address. Example: 100 Market St.
citystring- City. Example: San Francisco.
contact_status_idinteger- ID of the contact status. Get valid IDs from freshsales_selector_options_list with selector contact_statuses. Example: 16000000123.
countrystring- Country. Example: USA.
custom_fieldobject- Custom field values for the contact, keyed by the field's internal name (which starts with cf_). Example: {"cf_is_active": true, "cf_region": "EMEA"}.
emailsarray- Email addresses to set on the contact. Each item has value and is_primary; include the existing email's id to change it, or "_destroy": true with its id to remove it. Example: [{"value": "jane@acme.com", "is_primary": true}].
first_namestring- First name of the contact. Example: Jane.
job_titlestring- Job title of the contact. Example: VP Sales.
last_namestring- Last name of the contact. Example: Sampleton.
lead_source_idinteger- ID of the lead source. Get valid IDs from freshsales_selector_options_list with selector lead_sources. Example: 16000000123.
lifecycle_stage_idinteger- ID of the lifecycle stage. Get valid IDs from freshsales_selector_options_list with selector lifecycle_stages. Example: 16000000123.
mobile_numberstring- Mobile phone number; must be unique across contacts. Example: +1-415-555-0199.
owner_idinteger- ID of the Freshsales user who owns the contact. Get user IDs from freshsales_owners_list. Example: 16000012345.
sales_accountsarray- Accounts to link the contact to. Each item has the account id and is_primary (true for exactly one). Example: [{"id": 16000045678, "is_primary": true}].
statestring- State or region. Example: California.
territory_idinteger- ID of the territory. Get valid IDs from freshsales_selector_options_list with selector territories. Example: 16000000123.
work_numberstring- Work phone number. Example: +1-415-555-0100.
zipcodestring- Postal code. Example: 94105.
freshsales_deal_createCreate a deal (sales opportunity) in Freshsales, linked to an account.WriteCreate Deal
Create a deal (sales opportunity) in Freshsales, linked to an account. Returns the new deal with its id. Use freshsales_deal_update to move an existing deal to another stage or change its amount.
Inputs
amountnumberrequired- Value of the deal in the deal currency. Example: 23456.
namestringrequired- Name of the deal. Example: Acme - 50 seats.
sales_account_idintegerrequired- ID of the account the deal belongs to. Freshsales requires an account on every deal. Get it from freshsales_search or freshsales_sales_account_create. Example: 16000045678.
contacts_added_listarray- IDs of contacts to link to the deal. Example: [16000123456, 16000123457].
currency_idinteger- ID of the currency. Get valid IDs from freshsales_selector_options_list with selector currencies. Example: 16000000123.
custom_fieldobject- Custom field values for the deal, keyed by the field's internal name (which starts with cf_). Example: {"cf_is_active": true, "cf_region": "EMEA"}.
deal_pipeline_idinteger- ID of the deal pipeline. Get valid IDs from freshsales_selector_options_list with selector deal_pipelines. Example: 16000000123.
deal_stage_idinteger- ID of the deal stage. Get valid IDs from freshsales_selector_options_list with selector deal_stages. Example: 16000000123.
deal_type_idinteger- ID of the deal type. Get valid IDs from freshsales_selector_options_list with selector deal_types. Example: 16000000123.
expected_closestring- Date the deal is expected to close, as YYYY-MM-DD. Example: 2026-12-31.
lead_source_idinteger- ID of the lead source. Get valid IDs from freshsales_selector_options_list with selector lead_sources. Example: 16000000123.
owner_idinteger- ID of the Freshsales user who owns the deal. Get user IDs from freshsales_owners_list. Example: 16000012345.
probabilityinteger- Probability of winning the deal, from 0 to 100. Example: 60.
territory_idinteger- ID of the territory. Get valid IDs from freshsales_selector_options_list with selector territories. Example: 16000000123.
freshsales_deal_updateUpdate fields on an existing Freshsales deal, such as its stage, amount or linked contacts.WriteUpdate Deal
Update fields on an existing Freshsales deal, such as its stage, amount or linked contacts. Returns the updated deal. Only the fields you pass are changed. Use freshsales_deal_create to add a new deal.
- Idempotent
Inputs
deal_idintegerrequired- Numeric ID of the deal. Get it from freshsales_search or freshsales_deals_list. Example: 16000123456.
amountnumber- Value of the deal in the deal currency. Example: 23456.
contacts_added_listarray- IDs of contacts to link to the deal. Example: [16000123456, 16000123457].
contacts_removed_listarray- IDs of contacts to unlink from the deal. Example: [16000123457].
currency_idinteger- ID of the currency. Get valid IDs from freshsales_selector_options_list with selector currencies. Example: 16000000123.
custom_fieldobject- Custom field values for the deal, keyed by the field's internal name (which starts with cf_). Example: {"cf_is_active": true, "cf_region": "EMEA"}.
deal_pipeline_idinteger- ID of the deal pipeline. Get valid IDs from freshsales_selector_options_list with selector deal_pipelines. Example: 16000000123.
deal_reason_idinteger- ID of the reason the deal was lost; only allowed when the deal is in a Lost stage. Get valid IDs from freshsales_selector_options_list with selector deal_reasons. Example: 16000000123.
deal_stage_idinteger- ID of the deal stage. Get valid IDs from freshsales_selector_options_list with selector deal_stages. Example: 16000000123.
deal_type_idinteger- ID of the deal type. Get valid IDs from freshsales_selector_options_list with selector deal_types. Example: 16000000123.
expected_closestring- Date the deal is expected to close, as YYYY-MM-DD. Example: 2026-12-31.
lead_source_idinteger- ID of the lead source. Get valid IDs from freshsales_selector_options_list with selector lead_sources. Example: 16000000123.
namestring- Name of the deal. Example: Acme - 50 seats.
owner_idinteger- ID of the Freshsales user who owns the deal. Get user IDs from freshsales_owners_list. Example: 16000012345.
probabilityinteger- Probability of winning the deal, from 0 to 100. Example: 60.
sales_account_idinteger- ID of the account the deal belongs to. Freshsales requires an account on every deal. Get it from freshsales_search or freshsales_sales_account_create. Example: 16000045678.
territory_idinteger- ID of the territory. Get valid IDs from freshsales_selector_options_list with selector territories. Example: 16000000123.
freshsales_note_createAdd a note to a Freshsales contact, account or deal.WriteCreate Note
Add a note to a Freshsales contact, account or deal. Returns the new note with its id and timestamps. Use this to record free-text context. Use freshsales_sales_activity_create to log a call or meeting with an outcome.
Inputs
descriptionstringrequired- Text of the note. Example: Spoke with Jane; she wants a demo next week.
targetable_idintegerrequired- ID of the contact, account or deal the note is linked to, matching targetable_type. Example: 16000123456.
targetable_typestringrequired- Type of record the note is linked to: Contact, SalesAccount (an account) or Deal. Example: Contact.one of
ContactSalesAccountDeal
freshsales_sales_account_createCreate an account (a company) in Freshsales.WriteCreate Account
Create an account (a company) in Freshsales. Returns the new account with its id. Use freshsales_lookup with f=name first to avoid duplicates. Use freshsales_sales_account_update to change an existing account.
Inputs
namestringrequired- Name of the account (company); must be unique. Example: Acme Inc.
addressstring- Street address. Example: 100 Market St.
annual_revenuenumber- Annual revenue of the account. Example: 5000000.
business_type_idinteger- ID of the business type. Get valid IDs from freshsales_selector_options_list with selector business_types. Example: 16000000123.
citystring- City. Example: San Francisco.
countrystring- Country. Example: USA.
custom_fieldobject- Custom field values for the account, keyed by the field's internal name (which starts with cf_). Example: {"cf_is_active": true, "cf_region": "EMEA"}.
industry_type_idinteger- ID of the industry type. Get valid IDs from freshsales_selector_options_list with selector industry_types. Example: 16000000123.
owner_idinteger- ID of the Freshsales user who owns the account. Get user IDs from freshsales_owners_list. Example: 16000012345.
parent_sales_account_idinteger- ID of the parent account, for a subsidiary. Example: 16000045678.
phonestring- Main phone number. Example: +1-415-555-0100.
statestring- State or region. Example: California.
territory_idinteger- ID of the territory. Get valid IDs from freshsales_selector_options_list with selector territories. Example: 16000000123.
websitestring- Website of the account. Example: https://acme.com.
zipcodestring- Postal code. Example: 94105.
freshsales_sales_account_updateUpdate fields on an existing Freshsales account (company).WriteUpdate Account
Update fields on an existing Freshsales account (company). Returns the updated account. Only the fields you pass are changed. Use freshsales_sales_account_create to add a new account.
- Idempotent
Inputs
sales_account_idintegerrequired- Numeric ID of the account. Get it from freshsales_search or freshsales_sales_accounts_list. Example: 16000123456.
addressstring- Street address. Example: 100 Market St.
annual_revenuenumber- Annual revenue of the account. Example: 5000000.
business_type_idinteger- ID of the business type. Get valid IDs from freshsales_selector_options_list with selector business_types. Example: 16000000123.
citystring- City. Example: San Francisco.
countrystring- Country. Example: USA.
custom_fieldobject- Custom field values for the account, keyed by the field's internal name (which starts with cf_). Example: {"cf_is_active": true, "cf_region": "EMEA"}.
industry_type_idinteger- ID of the industry type. Get valid IDs from freshsales_selector_options_list with selector industry_types. Example: 16000000123.
namestring- Name of the account (company); must be unique. Example: Acme Inc.
owner_idinteger- ID of the Freshsales user who owns the account. Get user IDs from freshsales_owners_list. Example: 16000012345.
parent_sales_account_idinteger- ID of the parent account, for a subsidiary. Example: 16000045678.
phonestring- Main phone number. Example: +1-415-555-0100.
statestring- State or region. Example: California.
territory_idinteger- ID of the territory. Get valid IDs from freshsales_selector_options_list with selector territories. Example: 16000000123.
websitestring- Website of the account. Example: https://acme.com.
zipcodestring- Postal code. Example: 94105.
freshsales_sales_activity_createLog a sales activity, such as a call or meeting of a custom activity type, against a Freshsales contact, account or deal.WriteCreate Sales Activity
Log a sales activity, such as a call or meeting of a custom activity type, against a Freshsales contact, account or deal. Returns the new sales activity with its id. Use freshsales_note_create for plain notes and freshsales_appointment_create to schedule a future meeting.
Inputs
end_datestringrequired- End of the activity as an ISO 8601 datetime. Example: 2026-11-14T17:30:00+05:30.
owner_idintegerrequired- ID of the Freshsales user who owns the sales activity. Get user IDs from freshsales_owners_list. Example: 16000012345.
sales_activity_type_idintegerrequired- ID of the sales activity type (for example a call or meeting type). Get valid IDs from freshsales_selector_options_list with selector sales_activity_types. Example: 16000000123.
start_datestringrequired- Start of the activity as an ISO 8601 datetime. Example: 2026-11-14T17:00:00+05:30.
targetable_idintegerrequired- ID of the contact, account or deal the sales activity is linked to, matching targetable_type. Example: 16000123456.
targetable_typestringrequired- Type of record the sales activity is linked to: Contact, SalesAccount (an account) or Deal. Example: Contact.one of
ContactSalesAccountDeal titlestringrequired- Title of the sales activity. Example: Discovery call with Jane.
custom_fieldobject- Custom field values for the sales activity, keyed by the field's internal name (which starts with cf_). Example: {"cf_is_active": true, "cf_region": "EMEA"}.
locationstring- Where the activity took place. Example: Acme HQ.
notesstring- Notes about the activity. Example: Interested in the annual plan.
sales_activity_outcome_idinteger- ID of the outcome. Get valid IDs from freshsales_selector_options_list with selector sales_activity_outcomes. Example: 16000000123.
freshsales_sales_activity_updateUpdate an existing Freshsales sales activity, for example its outcome or notes.WriteUpdate Sales Activity
Update an existing Freshsales sales activity, for example its outcome or notes. Returns the updated sales activity. Only the fields you pass are changed. Use freshsales_sales_activity_create to log a new activity.
- Idempotent
Inputs
sales_activity_idintegerrequired- Numeric ID of the sales activity. Get it from freshsales_sales_activities_list. Example: 16000123456.
custom_fieldobject- Custom field values for the sales activity, keyed by the field's internal name (which starts with cf_). Example: {"cf_is_active": true, "cf_region": "EMEA"}.
end_datestring- End of the activity as an ISO 8601 datetime. Example: 2026-11-14T17:30:00+05:30.
locationstring- Where the activity took place. Example: Acme HQ.
notesstring- Notes about the activity. Example: Interested in the annual plan.
owner_idinteger- ID of the Freshsales user who owns the sales activity. Get user IDs from freshsales_owners_list. Example: 16000012345.
sales_activity_outcome_idinteger- ID of the outcome. Get valid IDs from freshsales_selector_options_list with selector sales_activity_outcomes. Example: 16000000123.
sales_activity_type_idinteger- ID of the sales activity type (for example a call or meeting type). Get valid IDs from freshsales_selector_options_list with selector sales_activity_types. Example: 16000000123.
start_datestring- Start of the activity as an ISO 8601 datetime. Example: 2026-11-14T17:00:00+05:30.
targetable_idinteger- ID of the contact, account or deal the sales activity is linked to, matching targetable_type. Example: 16000123456.
targetable_typestring- Type of record the sales activity is linked to: Contact, SalesAccount (an account) or Deal. Example: Contact.one of
ContactSalesAccountDeal titlestring- Title of the sales activity. Example: Discovery call with Jane.
freshsales_task_createCreate a to-do task in Freshsales linked to a contact, account or deal and assigned to a user.WriteCreate Task
Create a to-do task in Freshsales linked to a contact, account or deal and assigned to a user. Returns the new task with its id and status. Use freshsales_task_update to change or complete an existing task.
Inputs
due_datestringrequired- When the task is due, as an ISO 8601 datetime. Example: 2026-11-20T17:00:00Z.
owner_idintegerrequired- ID of the Freshsales user who owns the task. Get user IDs from freshsales_owners_list. Example: 16000012345.
targetable_idintegerrequired- ID of the contact, account or deal the task is linked to, matching targetable_type. Example: 16000123456.
targetable_typestringrequired- Type of record the task is linked to: Contact, SalesAccount (an account) or Deal. Example: Contact.one of
ContactSalesAccountDeal titlestringrequired- Title of the task. Example: Send pricing proposal.
collaborator_idsarray- IDs of Freshsales users to add to the task as collaborators. Get user IDs from freshsales_owners_list. Example: [16000012346].
descriptionstring- Details of the task. Example: Include the 50-seat volume discount.
outcome_idinteger- ID of the outcome. Get valid IDs from freshsales_selector_options_list with selector sales_activity_outcomes. Example: 16000000123.
task_type_idinteger- ID of the task type. Get valid IDs from freshsales_selector_options_list with selector sales_activity_types. Example: 16000000123.
freshsales_task_updateUpdate an existing Freshsales task, or mark it complete by setting status to 1.WriteUpdate Task
Update an existing Freshsales task, or mark it complete by setting status to 1. Returns the updated task. Only the fields you pass are changed. Use freshsales_task_create to add a new task.
- Idempotent
Inputs
task_idintegerrequired- Numeric ID of the task. Get it from freshsales_tasks_list. Example: 16000123456.
collaborator_idsarray- IDs of Freshsales users to add to the task as collaborators. Get user IDs from freshsales_owners_list. Example: [16000012346].
descriptionstring- Details of the task. Example: Include the 50-seat volume discount.
due_datestring- When the task is due, as an ISO 8601 datetime. Example: 2026-11-20T17:00:00Z.
outcome_idinteger- ID of the outcome. Get valid IDs from freshsales_selector_options_list with selector sales_activity_outcomes. Example: 16000000123.
owner_idinteger- ID of the Freshsales user who owns the task. Get user IDs from freshsales_owners_list. Example: 16000012345.
statusinteger- Task status: 0 = Open, 1 = Completed. Pass 1 to mark the task done. Example: 1.one of
01 targetable_idinteger- ID of the contact, account or deal the task is linked to, matching targetable_type. Example: 16000123456.
targetable_typestring- Type of record the task is linked to: Contact, SalesAccount (an account) or Deal. Example: Contact.one of
ContactSalesAccountDeal task_type_idinteger- ID of the task type. Get valid IDs from freshsales_selector_options_list with selector sales_activity_types. Example: 16000000123.
titlestring- Title of the task. Example: Send pricing proposal.
No tools match.