Menu

Management API

Introduction

The CINNOX Open API Management provides endpoints to do the following to your CINNOX service account:

API Endpoint Description Remark
Get External Contacts List This endpoint allows you to query all external contacts lists.
Get External Contact Activity This endpoint allows you to query the external contact's activity records.
Create External Contact This endpoint allows you to create an external contact. This endpoint does not support external contact custom fields.
Update External Contact This endpoint allows you to update external contact details. This endpoint does not support external contact custom fields.
Create/Edit/Delete Contact Event Subscription This endpoint allows you to subscribe to a webhook of a contact event, edit, and unsubscribe to the existing event. The event hook will return the contact information when the following events are triggered: * The external contact list is edited (Added contact, edited contact and deleted contact). * The external contact has been merged. * The external contact ownership was transferred. * The new staff contact is created. * The staff contact is updated. * The staff contact is deleted.
Create/Edit/Delete External Contact Event Subscription This endpoint allows you to subscribe to a webhook of an external contact event, edit, and unsubscribe to the existing event. The event hook will return the contact information when the following events are triggered: * The external contact list is updated (added, edited and deleted external contact) * The external contact has been merged.
Get Staff Contact List This endpoint allows you to get the staff contact list.
Create/Edit/Delete Staff Contact Event Subscription This endpoint allows you to subscribe to a webhook of a staff contact event, edit, and uns The event hook will return the contact information when the following events are triggered: * The new staff contact is created. * The staff contact is updated. * The staff contact is deleted.
Get Supported Language List This endpoint lets you retrieve the supported language list for creating the Service Group.
Get Supported Location List This endpoint lets you retrieve the supported location list for creating the Service Group.
Create Destination - Service Group This endpoint allows you to create a Service Group.
Update Destination - Service Group This endpoint allows you to update the existing Service group.
Get Destination List This endpoint allows you to retrieve the Tag and Destination lists.
Delete Destination - Service Group This endpoint allows you to delete the Service group.
Create Tag This endpoint allows you to create a tag.
Get Tag List This endpoint allows you to retrieve the tag lists.
Update Tag This endpoint allows you to update the existing tag.
Delete Tag This endpoint allows you to delete the existing tag.
Get Label List This endpoint allows you to retrieve the label list, including: * Label ID * Label Name * Label Colour * The staff who created the label * The staff who updated the label * The label creation day and time * The label update day and time
Delete Label This endpoint allows you to delete labels for an enquiry.
Label an Enquiry This endpoint allows you to add and update labels to an enquiry.
Unlabel an enquiry This endpoint allows you to remove labels to an enquiry.
Create/Edit/Delete Label Event Subscription This endpoint allows you to subscribe to a webhook of a label event, edit, and unsubscribe to the existing event. After the subscription, the event hook will return the label information when the event hook triggers are due to the following ​events: * A new label is created * A label is edited ​ * A label is deleted ​

📘

CINNOX Open API support up to 500 requests per min per service account.

Previous
Management API
Next
Create/Edit/Delete External Contact Event Subscription
Last modified: 2025-12-09