• Customermates logo
    CustomermatesDocumentation
  • Introduction
  • Comparison
Getting Started
  • Quickstart
  • Core Concepts
  • From Pipedrive
Integrations
  • Introduction
  • MCP
  • Connect Claude Desktop
  • Connect ChatGPT
  • Connect Cursor
  • Webhooks
  • OpenAPI 3.1.0
  • N8N
Self-Hosting
  • Self-Hosted vs Cloud
  • Get Started
  • Managing Your Installation
  • Architecture & Security
Reference
  • Setup AI Assistant
  • MCP Tool Catalog
  • Webhook Events
  • Filter Syntax
  • API Keys
  • Go back
  1. Introduction
  2. OpenAPI 3.1.0

OpenAPI 3.1.0: API Reference

Browse API endpoints, inspect request and response formats, and use the OpenAPI reference as the starting point for integrations and custom workflows.

Performing operations in the API playground will affect your live data.

Create a contact

POST

Creates a new contact. First name and last name are required. All other fields are optional.

Create many contacts

POST

Creates many contacts in a single request. Each contact requires first name and last name. All other fields are optional.

Delete a contact

DELETE

Deletes a contact from the database.

Delete many contacts

DELETE

Deletes many contacts by their IDs in a single request. This operation cannot be undone.

Get a contact by ID

GET

Retrieves a single contact by its unique identifier.

Get contacts configuration

GET

Retrieves configuration for contacts API, including available custom columns, filterable fields, and sortable fields.

Get contacts

POST

Retrieves a list of contacts with optional filtering, sorting, and pagination.

Update a contact

PUT

Updates an existing contact. Only provided fields are updated. Set fields to null to clear them.

Update many contacts

PUT

Updates many contacts in a single request. Each contact requires an ID. All other fields are optional.

Contact Created

WEBHOOK

Sent when a contact is created.

Contact Deleted

WEBHOOK

Sent when a contact is deleted.

Contact Updated

WEBHOOK

Sent when a contact is updated.

Create many organizations

POST

Creates many organizations in a single request. Each organization requires a name. All other fields are optional.

Create an organization

POST

Creates a new organization. Name is required. All other fields are optional.

Delete many organizations

DELETE

Deletes many organizations by their IDs in a single request. This operation cannot be undone.

Delete an organization

DELETE

Deletes an organization from the database.

Get an organization by ID

GET

Retrieves a single organization by its unique identifier.

Get organizations configuration

GET

Retrieves configuration for organizations API, including available custom columns, filterable fields, and sortable fields.

Get organizations

POST

Retrieves a list of organizations with optional filtering, sorting, and pagination.

Update many organizations

PUT

Updates many organizations in a single request. Each organization requires an ID. All other fields are optional.

Update an organization

PUT

Updates an existing organization. Only provided fields are updated. Set fields to null to clear them.

Organization Created

WEBHOOK

Sent when an organization is created.

Organization Deleted

WEBHOOK

Sent when an organization is deleted.

Organization Updated

WEBHOOK

Sent when an organization is updated.

Create a deal

POST

Creates a new deal. Name is required. All other fields are optional.

Create many deals

POST

Creates many deals in a single request. Each deal requires a name. All other fields are optional. Deals can include services with quantities using the services array.

Delete a deal

DELETE

Deletes a deal from the database.

Delete many deals

DELETE

Deletes many deals by their IDs in a single request. This operation cannot be undone.

Get a deal by ID

GET

Retrieves a single deal by its unique identifier.

Get deals configuration

GET

Retrieves configuration for deals API, including available custom columns, filterable fields, and sortable fields.

Get deals

POST

Retrieves a list of deals with optional filtering, sorting, and pagination.

Update a deal

PUT

Updates an existing deal. Only provided fields are updated. Set fields to null to clear them.

Update many deals

PUT

Updates many deals in a single request. Each deal requires an ID. All other fields are optional. You can update services by providing a services array with serviceId and quantity.

Deal Created

WEBHOOK

Sent when a deal is created.

Deal Deleted

WEBHOOK

Sent when a deal is deleted.

Deal Updated

WEBHOOK

Sent when a deal is updated.

Create many services

POST

Creates many services in a single request. Each service requires a name and an amount (must be greater than 0). All other fields are optional.

Create a service

POST

Creates a new service. Name and amount are required. All other fields are optional.

Delete many services

DELETE

Deletes many services by their IDs in a single request. This operation cannot be undone.

Delete a service

DELETE

Deletes a service from the database.

Get a service by ID

GET

Retrieves a single service by its unique identifier.

Get services configuration

GET

Retrieves configuration for services API, including available custom columns, filterable fields, and sortable fields.

Get services

POST

Retrieves a list of services with optional filtering, sorting, and pagination.

Update many services

PUT

Updates many services in a single request. Each service requires an ID. All other fields are optional.

Update a service

PUT

Updates an existing service. Only provided fields are updated. Set fields to null to clear them.

Service Created

WEBHOOK

Sent when a service is created.

Service Deleted

WEBHOOK

Sent when a service is deleted.

Service Updated

WEBHOOK

Sent when a service is updated.

Create many tasks

POST

Creates many tasks in a single request. Each task requires a name. All other fields are optional.

Create a task

POST

Creates a new task. Name is required. All other fields are optional.

Delete many tasks

DELETE

Deletes many tasks by their IDs in a single request. This operation cannot be undone.

Delete a task

DELETE

Deletes a task from the database.

Get a task by ID

GET

Retrieves a single task by its unique identifier.

Get tasks configuration

GET

Retrieves configuration for tasks API, including available custom columns, filterable fields, and sortable fields.

Get tasks

POST

Retrieves a list of tasks with optional filtering, sorting, and pagination.

Update many tasks

PUT

Updates many tasks in a single request. Each task requires an ID. All other fields are optional.

Update a task

PUT

Updates an existing task. Only provided fields are updated. Set fields to null to clear them.

Task Created

WEBHOOK

Sent when a task is created.

Task Deleted

WEBHOOK

Sent when a task is deleted.

Task Updated

WEBHOOK

Sent when a task is updated.

Get own user profile

GET

Retrieves the authenticated user's profile information.

Get users

POST

Retrieves a list of users with optional sorting and pagination.