Skip to main content

Prerequisites

Before continuing, you should have already completed the following for this connector:
1

Configure the Connector

Enable the connector and set up its connector profile in your project. See Managing Connectors.

Connector Profile

Freshsales - API Key
2

Link an Account

Connect an account using StackOne Hub or Auth Link.

Link Account

Freshsales - API Key

Send Freshsales events to StackOne via a Workflow webhook

Copy the Native Webhook URL from this StackOne connection and use it as the Enter callback URL value of a Trigger webhook action in a Freshsales Workflow, so Freshsales posts data to StackOne when the workflow’s conditions are met.

1

Copy the Native Webhook URL from StackOne

On this connection in StackOne, copy the read-only Native Webhook URL. It contains a secure per-connection key, so treat it like a secret — you will paste it into Freshsales in a later step.

2

Open Workflows in Freshsales

Sign in to Freshsales as an Admin and open Admin Settings. Search settings for Workflows and open Set up automated actions based on trigger conditions.

Freshsales Admin Settings with the Workflows (Set up automated actions based on trigger conditions) result
3

Create a workflow

On the Workflows page, click Create workflow.

Freshsales Workflows page with the Create workflow button
4

Choose the module, trigger, and conditions

Under Run this workflow for, pick the Module the events should come from — Contacts, Accounts, Deals, or a Sales activities type (Tasks, Meetings, Call logs). Under When to trigger this workflow? set the Trigger (for example, when contact is created or updated), and optionally add conditions under What conditions should be met?

Freshsales workflow builder showing Run this workflow for (Modules), When to trigger this workflow, and What actions should be executed
5

Add a Trigger webhook action

Under What actions should be executed?, click Add action, open Select action, and choose Trigger webhook. Then click Edit webhook settings.

Freshsales workflow action list with the Trigger webhook option selected
6

Configure the Webhook Settings

In the Webhook Settings panel, complete the fields below, then click Save.

  • Select request method — choose POST.
  • Enter callback URL — paste the Native Webhook URL you copied from this StackOne connection.
  • Select encoding format — choose JSON.
  • Compose request body — choose Simple, then under Content select the record’s Contact id (StackOne uses it as the record id) plus any other fields you want to send. You can use Select all.
  • Leave Requires authentication off — the secure key in the Native Webhook URL is the security gate.
  • Optionally click Test this webhook to confirm StackOne accepts it, then Save.
Freshsales Webhook Settings panel with Select request method POST, Enter callback URL, Select encoding format JSON, Compose request body Simple, Content field checkboxes, and Save
7

Save the webhook, then enable the workflow

Click Save in the Webhook Settings panel to return to the workflow builder. In the builder’s toolbar at the top of the page you’ll see Save as draft, Test workflow, and Enable. Click Test workflow first if you want to send a one-off test delivery, then click Enable to switch the workflow on. Once enabled, Freshsales POSTs the payload to the callback URL every time the trigger fires and the conditions are met.

Freshsales workflow builder toolbar showing the Save as draft, Test workflow, and Enable buttons

Available webhook events

A Freshsales Workflow can send events from any of these modules — build one workflow per module and trigger you want to receive. Only the fields you select in the workflow’s Content are delivered.

  • Contacts — a contact is created or updated (or field-specific triggers you choose).
  • Accounts — an account is created or updated.
  • Deals — a deal is created or updated (including stage changes).
  • Tasks — a task is created, updated, or completed.
  • Meetings — a meeting/appointment is created or updated.
  • Call logs — a call log is created or updated.

Delivery format

Freshsales sends each event as a single HTTPS POST with the JSON body you composed in the workflow (the selected Content fields, flat and prefixed by record type — e.g. contact_id, contact_email). Because the body is admin-defined, StackOne passes the full payload through as the event data and derives the record id from the record’s id field (e.g. contact_id). There is no verification handshake, and the secure key in the callback URL authenticates the delivery.

Verify

Your Connector should now be able to receive and process events. Try triggering an event and you should see an Event appear in the Connector logs.