WebHooks API

SupportDesk WebHooks Integration allows calls to be automatically pushed to another SupportDesk system as new calls. It can also be used to update certain fields in existing calls via an HTTPS JSON API.

Call field changes and notes made in either SupportDesk system will then be automatically synchronised to the other system.

The call fields that are synchronised are


The initial ‘push’ of a call from one end to the other is controlled using a custom tag against one or more categories. This enables one of the Type, Status or Priority values to control this. So a call may be raised in one system, then at a later time pushed to the other system. After this, the fields will be kept in-sync.

Successful synchronisation does depend on the two systems having identically named categories (Types, Status, Priority) and logins (Assignee, Owner).

Synchronisation is via an HTTP(S) JSON WebHook API, so both ends must be accessible to each other via an HTTP(S) URL.

Example using the curl command line tool to perform a manual HTTP request to update a call status using basic authentication.

curl -X POST -H “Content-Type:application/json”

JSON format showing sample data values on the right.
If “reference” is empty or missing a new call is created.

	"call" :
		"contact":"Buddy Dog",
		"level":"24 Hour",
		"subject":"Test Call Subject",
		"description":"Test Call Description",
		"text1":"text1 etc. 1-6”