1. Introduction
Commusoft developer
  • Introduction
    • Introduction
    • Key concepts and relationships
    • Authentication
    • Rate-limits
    • Requests and responses
    • Core concepts and patters
    • Support and technical support
  • CRM
    • Properties
      • List properties
      • Properties
      • Customers
      • Companies
      • Work addresses
      • Customers
      • Companies
      • Work addresses
      • Properties
    • Contacts
      • List property contacts
      • Property contacts
      • Property contacts
      • Property contacts
    • Scheduled activities
      • List scheduled activities
      • Scheduled activities
      • Scheduled activities
      • Scheduled activities
      • Complete Scheduled Activity
  • Sales
    • Opportunities
      • List opportunities
      • Opportunities
      • Opportunities
      • Opportunities
      • Opportunities
    • Actions
      • Change opportunity stage
  • Jobs
    • Jobs
      • List jobs
      • Jobs
      • Jobs
      • Jobs
      • Jobs
    • Actions
      • Put on hold
      • Mark as free of charge
      • Mark as aborted
      • Change job stage
      • Mark as complete
      • Remove on hold
  • Settings
    • List titles
      GET
    • List customer types
      GET
    • List advertising types
      GET
    • List telephone types
      GET
    • List business units
      GET
    • List user groups
      GET
    • List opportunity pipelines
      GET
    • List opportunity stages
      GET
    • List provinces
      GET
    • List job description templates
      GET
  • Webhooks
    • Webhooks
    • Example PHP script
    • Webhooks
    • Webhooks
  1. Introduction

Authentication

To ensure the security of your data, the Commusoft v2 API requires an active API Key for every request. All communication must be conducted over HTTPS.

API Keys#

Your API Key acts as a powerful credential that provides access to your Commusoft account data.
Private Apps: Keys can be generated directly within the Commusoft /Settings/Private applications by an administrator.
Partners: Will use oAuth as part of your authentication flow. This allows the partner to connect to one or many Commusoft clients. This will be discussed with you once you've completed onboarding on the partner program. To register, go to www.commusoft.com/partners
Security: Treat your API Key like a password. Never share it in public repositories, client-side code (like frontend JavaScript), or insecure communication channels.

Using Your Key#

To authenticate, you must include your key in the x-api-key header of every HTTP request.
Example Header
x-api-key: your_api_key_here

Environments#

We provide two distinct environments to ensure you can develop and test your integration safely:
Production
UK production: https://app.commusoft.co.uk/api/v2
US/Canada production: https://app.commusoft.us/api/v2
Please use the appropriate URL based on the location of the business.
Sandbox
Available on request and may come with additional charges.
Important: API Keys are environment-specific. A key generated for the Sandbox environment will not work on the Production environment, and vice versa.
Modified at 2026-08-03 16:52:00
Previous
Key concepts and relationships
Next
Rate-limits
Built with