- name
- freshsales
- description
- Freshsales CRM integration — manage contacts, leads, deals, accounts, tasks, and sales sequences via the Freshsales API. Track deal pipelines, automate lead assignments, log activities, and generate sales reports. Built for AI agents — Python stdlib only, no dependencies. Use for sales CRM, contact management, deal tracking, pipeline reporting, and sales automation.
- homepage
- https://www.agxntsix.ai
- license
- MIT
- compatibility
- Python 3.10+ (stdlib only — no dependencies)
- metadata
- {"openclaw": {"emoji": "🟢", "requires": {"env": ["FRESHSALES_API_KEY", "FRESHSALES_DOMAIN"]}, "primaryEnv": "FRESHSALES_API_KEY", "homepage": "https://www.agxntsix.ai"}}
🟢 Freshsales
Freshsales CRM integration — manage contacts, leads, deals, accounts, tasks, and sales sequences via the Freshsales API.
Features
- Manage contacts — create, update, search, and segment
- Lead tracking — capture, qualify, assign, and convert
- Deal pipeline — stages, values, forecasting, and won/lost
- Account management — company profiles and hierarchies
- Task management — create, assign, and track sales tasks
- Activity logging — calls, emails, meetings, and notes
- Sales sequences — view and manage outreach campaigns
- Search across contacts, leads, deals, and accounts
- Reports — pipeline value, conversion rates, activity metrics
- Filters — custom views with field-level filtering
Requirements
| Variable | Required | Description |
|---|---|---|
FRESHSALES_API_KEY | ✅ | API key/token for Freshsales |
FRESHSALES_DOMAIN | ✅ | Your Freshsales domain (e.g. yourorg.freshsales.io) |
Quick Start
# List contacts
python3 {baseDir}/scripts/freshsales.py contacts --limit 20# Get contact details
python3 {baseDir}/scripts/freshsales.py contact-get 12345# Create a contact
python3 {baseDir}/scripts/freshsales.py contact-create '{"first_name":"Jane","last_name":"Doe","email":"jane@example.com"}'# Update a contact
python3 {baseDir}/scripts/freshsales.py contact-update 12345 '{"lead_score":85}'Commands
contacts
List contacts.
python3 {baseDir}/scripts/freshsales.py contacts --limit 20contact-get
Get contact details.
python3 {baseDir}/scripts/freshsales.py contact-get 12345contact-create
Create a contact.
python3 {baseDir}/scripts/freshsales.py contact-create '{"first_name":"Jane","last_name":"Doe","email":"jane@example.com"}'contact-update
Update a contact.
python3 {baseDir}/scripts/freshsales.py contact-update 12345 '{"lead_score":85}'leads
List leads.
python3 {baseDir}/scripts/freshsales.py leads --limit 20 --sort updated_atlead-create
Create a lead.
python3 {baseDir}/scripts/freshsales.py lead-create '{"first_name":"John","company":"Acme"}'deals
List deals.
python3 {baseDir}/scripts/freshsales.py deals --limit 20deal-create
Create a deal.
python3 {baseDir}/scripts/freshsales.py deal-create '{"name":"Acme Upgrade","amount":50000}'deal-update
Update deal stage.
python3 {baseDir}/scripts/freshsales.py deal-update 789 '{"deal_stage_id":3}'accounts
List accounts.
python3 {baseDir}/scripts/freshsales.py accounts --limit 20tasks
List tasks.
python3 {baseDir}/scripts/freshsales.py tasks --limit 10 --status opentask-create
Create a task.
python3 {baseDir}/scripts/freshsales.py task-create '{"title":"Follow up with Acme","due_date":"2026-03-01"}'search
Search across all entities.
python3 {baseDir}/scripts/freshsales.py search "Acme"activities
List recent activities.
python3 {baseDir}/scripts/freshsales.py activities --limit 20pipeline
Pipeline summary.
python3 {baseDir}/scripts/freshsales.py pipelineOutput Format
All commands output JSON by default. Add --human for readable formatted output.
# JSON (default, for programmatic use)
python3 {baseDir}/scripts/freshsales.py contacts --limit 5
# Human-readable
python3 {baseDir}/scripts/freshsales.py contacts --limit 5 --humanScript Reference
| Script | Description |
|---|---|
{baseDir}/scripts/freshsales.py | Main CLI — all Freshsales operations |
Data Policy
This skill never stores data locally. All requests go directly to the Freshsales API and results are returned to stdout. Your data stays on Freshsales servers.
Credits
Built by M. Abidi | agxntsix.ai YouTube | GitHub Part of the AgxntSix Skill Suite for OpenClaw agents.
📅 Need help setting up OpenClaw for your business? Book a free consultation