• Customermates Logo
    CustomermatesDocumentation
  • Einführung
Erste Schritte
  • Quickstart
  • Kernkonzepte
KI verbinden
  • Custom Connector
  • CLI & Editoren
  • Ratenlimits
Integrationen
  • MCP
  • Webhooks
  • OpenAPI 3.1.0
  • N8N
Self-Hosting
  • Get Started
  • Architektur & Sicherheit
App-Leitfaden
  • Dashboard
  • Posteingang
  • Datensätze
  • Profil
  • Unternehmen
  • API-Keys
  • Filter-Syntax
  • Zurück
  1. Einführung
  2. OpenAPI 3.1.0

OpenAPI 3.1.0: API-Referenz

API-Endpunkte durchsuchen, Request- und Response-Formate prüfen und die OpenAPI-Referenz als Einstiegspunkt für Integrationen und eigene Workflows nutzen.

Das Ausführen von Operationen im API-Playground wirkt sich auf Ihre Live-Daten aus.

Die technische API-Endpunkt-Dokumentation ist nur auf Englisch verfügbar. Dies liegt daran, dass API-Dokumentation präzise technische Terminologie und Konsistenz mit Industriestandards erfordert.

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 id (UUID, email/phone, or provider:value handle) 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 is addressed by id (the contact UUID, an email or phone, or 'provider:value' for a handle). 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 filtering, sorting and pagination.

Accept a relation request

POST

Accepts a received relation request by invitationId on a connected LinkedIn or Instagram account. Requires a connected LinkedIn or Instagram account.

Browse a Sales Navigator list

POST

Returns the leads (kind leads, default) or accounts (kind accounts) saved in a Sales Navigator list of a connected LinkedIn account, page by page (offset pagination).

Cancel a relation request

POST

Withdraws or refuses a relation request by invitationId on a connected LinkedIn or Instagram account. Requires a connected LinkedIn or Instagram account.

Send a relation request

POST

Sends a real connection / relation request from a connected LinkedIn or Instagram account to identifier, with an optional short message. Requires a connected LinkedIn or Instagram account.

Create a webhook subscription

POST

Subscribes an endpoint to the given events (url and events are required). Deliveries are signed with HMAC-SHA-256 in the X-Webhook-Signature header when a secret is set. The signing secret is never returned. Providing an existing id updates that subscription instead.

Delete a webhook subscription

DELETE

Removes a webhook subscription so it stops receiving deliveries.

Discard a message draft

DELETE

Deletes a draft message by its id. Only draft messages can be discarded; sent messages are unaffected.

Get activities

POST

Retrieves the activity timeline (messages, audit-log changes, calendar events) for the workspace or one record, with optional scoping to a single entity, sorting, and pagination.

Get a calendar by ID

GET

Fetches one calendar of a connected account visible to the caller, or null when no calendar with this id is accessible. The id matches the entityId of the messaging.calendar.changed webhook event.

Get a calendar event by ID

GET

Fetches one calendar event visible to the caller, including organizer and attendees, or null when no event with this id is accessible. The id matches the entityId of the messaging.calendar.event.changed webhook event.

Get calendar events

POST

Retrieves calendar events visible to the caller, ordered by start time, with optional filtering (calendarId, connectedAccountId, startsAt date range), sorting, and pagination. Event ids match the entityId of the messaging.calendar.event.changed webhook event.

Get calendars

POST

Retrieves the calendars of connected accounts visible to the caller (own accounts plus shared ones), with optional filtering (connectedAccountId), search, sorting, and pagination. Calendar ids match the entityId of the messaging.calendar.changed webhook event.

List own connected accounts

GET

Lists the messaging accounts connected to the workspace and visible to the authenticated user.

Get a messaging thread by ID

GET

Fetches one message thread with its full message list. Returns the thread plus each message's direction, sender, subject, text body, and attachment metadata (HTML bodies and raw attachment urls are omitted).

Get messaging threads

POST

Retrieves a list of inbox message threads with optional search, sorting, and pagination.

List post comments or reactions

POST

Reads engagement on a social post: kind=comments (default) lists the post's comments, kind=reactions lists who reacted to the post, or set commentId to list reactions on that specific comment (kind is ignored). Requires a connected LinkedIn or Instagram account.

List or fetch social posts

POST

Reads LinkedIn or Instagram posts from a connected account. Omit postId to list an author's posts (authorIdentifier defaults to the account holder); set postId to fetch one post. Requires a connected LinkedIn or Instagram account.

Get a social profile

POST

Reads a LinkedIn or Instagram profile by identifier from a connected account. On LinkedIn the identifier is the public identifier or a provider member id (use 'me' for the account owner); on Instagram it is the username. Requires a connected LinkedIn or Instagram account.

Get a webhook subscription

GET

Returns one webhook subscription by ID. The signing secret itself is never returned.

List received relation requests

POST

Lists the connection / relation requests received by the owner of a connected LinkedIn or Instagram account. Requires a connected LinkedIn or Instagram account.

List Sales Navigator lists

POST

Lists the Sales Navigator lead lists (kind leads, default) or account lists (kind accounts) of a connected LinkedIn account. Lists can only be created in the Sales Navigator UI; the API reads and fills existing lists.

List Sales Navigator search parameters

POST

Resolves the parameter ids used by the Sales Navigator people and company search filters. Pass a type (LOCATION, INDUSTRY, JOB_TITLE, COMPANY, LEAD_LIST, ACCOUNT_LIST and more) and optional keywords to look up matching ids with display names. LEAD_LIST and ACCOUNT_LIST also resolve existing list ids by name.

Save a message draft

POST

Saves or updates the draft reply on a thread for the current user to review and send from the inbox. Local only; nothing is delivered. subject, cc, and bcc apply to email threads. There is one draft per thread; saving again replaces it.

Save a lead or account to a Sales Navigator list

POST

Saves a person (kind leads, providerId is the LinkedIn user id) or a company (kind accounts, providerId is the LinkedIn company id) to an existing Sales Navigator list on a connected LinkedIn account. New lists must be created in the Sales Navigator UI first.

Search Sales Navigator companies (accounts)

POST

Runs a structured LinkedIn Sales Navigator company search through a connected LinkedIn account. Filters take parameter ids resolved via the search-parameters endpoint (location, industry, account lists) plus native ranges like headcount, annual revenue and spotlights. Returns company rows page by page (offset pagination, LinkedIn caps a single company search at 1000 results). Requires the connected account to have a Sales Navigator subscription.

Run a Sales Navigator search from a URL

POST

Executes a LinkedIn Sales Navigator search from a pasted search URL through a connected LinkedIn account and returns the result rows page by page (offset pagination). Requires the connected account to have a Sales Navigator subscription.

Search Sales Navigator people (leads)

POST

Runs a structured LinkedIn Sales Navigator people search through a connected LinkedIn account. Filters take parameter ids resolved via the search-parameters endpoint (location, industry, company, job title, and more) plus native enums like seniority and company headcount. Returns lead rows page by page (offset pagination, LinkedIn caps a single search at 2500 results). Requires the connected account to have a Sales Navigator subscription.

Send a chat message

POST

Sends a real message into an existing chat thread (LinkedIn, WhatsApp, etc.). This delivers a real message as a side effect.

Send an email

POST

Sends a real email (or reply) from a connected email account. Provide either threadId (reply; takes precedence if both are given) or connectedAccountId (new email). cc and bcc are plain email strings, unlike to which uses the { identifier } object form.

Start a chat

POST

Starts a new chat thread (LinkedIn, WhatsApp, etc.) with one or more attendees from a connected account and sends the first message. This delivers a real message as a side effect.

Calendar Changed

WEBHOOK

Sent when a calendar on a connected account is created, updated, or deleted.

Calendar Event Changed

WEBHOOK

Sent when a calendar event on a connected account is created, updated, or deleted.

Chat Deleted

WEBHOOK

Sent when the provider reports a chat thread deletion.

Chat Updated

WEBHOOK

Sent when a chat thread's provider attributes change (name, mute state, read state).

Email Deleted

WEBHOOK

Sent when the provider reports an email deletion.

Email Received

WEBHOOK

Sent when a new email is ingested on a connected email account.

Message Deleted

WEBHOOK

Sent when the provider reports a message deletion.

Message Reaction

WEBHOOK

Sent when a reaction is added to or removed from a message.

Message Received

WEBHOOK

Sent when a new chat message or email is ingested on a connected account.

Message Updated

WEBHOOK

Sent when the provider reports an edit or status change for an ingested message.

Relation Created

WEBHOOK

Sent when the provider reports a new connection (e.g. an accepted LinkedIn invitation).