API Documentation
Build on the KudosCRM API
A REST API and webhooks to sync your CRM data, automate your pipeline, and connect the tools your team already runs on.
The KudosCRM API gives developers a clean, predictable way to read and write the records that drive your sales motion. Pull contacts into your data warehouse, push deals from another system, enrich companies, or trigger your own automations the moment something changes. Everything is served over HTTPS from app.kudoscrm.com, returns JSON, and follows REST conventions you already know.
Authenticate once, then work with the same core resources you see in the product: contacts, companies, deals, custom objects, and activities. Need to react to changes in real time? Subscribe to webhooks and let KudosCRM push events to your endpoint instead of polling. This page is your high-level map; pair it with the in-product developer settings to generate credentials and get going.
Getting started
Base URL
Every API request is made over HTTPS to app.kudoscrm.com. Requests and responses use JSON, and standard HTTP status codes tell you whether a call succeeded, was rejected, or hit an error.
Authentication
Two ways to connect: an API key for server-to-server scripts and internal integrations, or OAuth when you are building an app that acts on behalf of other KudosCRM users. Generate and manage credentials in your workspace developer settings.
Your first request
Create credentials, send an authenticated request to a read endpoint such as contacts, and confirm you get a JSON response. From there you can list, create, update, and delete records the same way across resources.
Tiers and access
API access is part of the KudosCRM plans. Heavier programmatic use and advanced controls scale with Professional and Enterprise. Check your plan details for what is included before you build.
Core resources
Contacts
Read and write the people in your CRM. Create new contacts from a signup form, update details from another system, or sync your full contact list into a reporting tool of your choice.
Companies
Manage the organizations behind your deals. Enrich company records, link them to contacts, and keep account data consistent across every system your team touches.
Deals
Work with the opportunities in your pipeline. Create deals, move them between stages, update amounts, and keep your forecast in sync with whatever drives revenue in your stack.
Custom objects
Model the data that is unique to your business. If you have extended KudosCRM with custom objects, the API lets you read and write those records alongside the standard ones.
Activities
Capture the work that happens around a record: calls, emails, meetings, and notes. Log activities programmatically so your timeline reflects engagement from every channel.
Webhooks and automation
Subscribe to events
Register a webhook endpoint and KudosCRM will send you a JSON payload when something changes, like a deal moving stages or a new contact being created. React in real time instead of polling for updates.
Event-driven workflows
Pair webhooks with your own logic to keep external systems in step with your CRM. When a deal is won, kick off provisioning; when a contact is added, sync it to your marketing tool.
Verify and secure
Treat incoming webhook requests as untrusted until verified. Validate each delivery before acting on it, and keep your API keys and OAuth secrets out of client-side code and version control.
Pair with Kudos AI
The API and webhooks complement what Kudos AI does inside the product. Push clean, structured data in through the API and let your team work it alongside KudosCRM's built-in copilot.
FAQ
Frequently asked
Start free today
Ready to give your team a CRM they'll actually use?
Start free. Bring your whole team. Cancel whenever (you won't).