Management API

Introduction

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

API EndpointDescriptionRemark
Get External Contacts ListThis endpoint allows you to query all external contacts lists.
Get External Contact ActivityThis endpoint allows you to query the external contact's activity records.
Create External ContactThis endpoint allows you to create an external contact.This endpoint does not support external contact custom fields.
Update External ContactThis endpoint allows you to update external contact details.This endpoint does not support external contact custom fields.
Create/Edit/Delete Contact Event SubscriptionThis 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 SubscriptionThis 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 ListThis endpoint allows you to get the staff contact list.
Create/Edit/Delete Staff Contact Event SubscriptionThis endpoint allows you to subscribe to a webhook of a staff contact event, edit, and unsThe 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 ListThis endpoint lets you retrieve the supported language list for creating the Service Group.
Get Supported Location ListThis endpoint lets you retrieve the supported location list for creating the Service Group.
Create Destination - Service GroupThis endpoint allows you to create a Service Group.
Update Destination - Service GroupThis endpoint allows you to update the existing Service group.
Get Destination ListThis endpoint allows you to retrieve the Tag and Destination lists.
Delete Destination - Service GroupThis endpoint allows you to delete the Service group.
Create TagThis endpoint allows you to create a tag.
Get Tag ListThis endpoint allows you to retrieve the tag lists.
Update TagThis endpoint allows you to update the existing tag.
Delete TagThis endpoint allows you to delete the existing tag.
Get Label ListThis 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 LabelThis endpoint allows you to delete labels for an enquiry.
Label an EnquiryThis endpoint allows you to add and update labels to an enquiry.
Unlabel an enquiryThis endpoint allows you to remove labels to an enquiry.
Create/Edit/Delete Label Event SubscriptionThis 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.