Skip to main content

​
Setup Guide

​
Add your Freshsales app to Paragon

Under Integrations > Connected Integrations > Freshsales > App Configuration > Configure, fill out your credentials from your developer app in their respective sections:
  • Domain: Found under https://[domain].myfreshworks.com/
  • API Key: Found under Profile Settings > API Settings > Your API Key on your Freshsales settings page.
This is an API-only integration - workflow actions for this integration are still in development. You can still connect user accounts, build workflows, and access the API for this integration.

​
Connecting to Freshsales

Your users will need the following information to connect their Freshsales account with your integration built with Paragon Connect:
  • Domain
  • API Key
Once your users have connected their Freshsales account, you can use the Paragon SDK to access the Freshsales API on behalf of connected users. See the Freshsales REST API documentation for their full API reference. Any Freshsales API endpoints can be accessed with the Paragon SDK as shown in this example. 
// You can find your project ID in the Overview tab of any Integration

// Authenticate the user
paragon.authenticate(<ProjectId>, <UserToken>);
            
// Create a Contact
await paragon.request("freshsales", "/contacts", {
  method: "POST",
  body: {
    "contact": {
        "first_name": "James",
        "last_name": "Westwood",
        "mobile_number":"1-926-555-9503"
    }
  }
});

// Create a Lead
await paragon.request("freshsales", "/leads", {
  method: "POST",
  body: {
  "lead": {
         "first_name": "Foo",
         "last_name": "Westwood",
         "mobile_number":"1-926-652-9503",
         "company": { 
            "name": "Widgetz.io"
        } 
    }
  }
});

// Get all Deals
await paragon.request("freshsales", "/deals/view/<view_id>", {
  method: "GET"
});

​
Building Freshsales workflows

Once your Freshsales account is connected, you use the Freshsales Request step to access any of Freshsales’s API endpoints without the authentication piece. When creating or updating records in Freshsales, you can reference data from previous steps by typing {{ to invoke the variable menu.
⌘I