Skip to main content

Categories

Categories webhooks notify you when a category is created, updated, or deleted in the MX system for any user on your client.

FieldData TypeDefinition
created_atIntegerThe date and time at which the category was completed.
guidStringThe unique identifier for the category. Defined by MX.
is_defaultBooleanThis indicates whether the category is a default category.
is_incomeBooleanThis indicates whether the category represents income.
metadataStringAdditional information a partner can store on the category.
nameStringThe name of the category that is visible to the user.
parent_guidStringThe parent GUID of the category.
revisionIntegerThe revision number for the category.
updated_atIntegerThe date and time at which the category was updated.
user_guidStringThe unique identifier for the user the category is attached to. Defined by MX.
user_idStringThe unique partner-defined identifier for the user.

Example Payload


_23
POST https://abc.com/admin/webhooks
_23
HTTP/1.1
_23
content-type: application/json; charset=utf-8
_23
accept: application/json
_23
User-Agent: HTTPClient/1.0 (2.7.1, ruby 2.2.2
_23
(2015-09-02)) Date: Thu, 14 Apr 2016 04:26:04 GMT Content-Length: 231
_23
Host: abc.com
_23
{
_23
"action": "updated",
_23
"category": {
_23
"created_at": 1234567890,
_23
"guid": "CAT-123",
_23
"is_default": false,
_23
"is_income": true,
_23
"metadata": "metadata~set~by~partner",
_23
"name": "Coffee",
_23
"parent_guid": "CAT-bd56d35a-a9a7-6e10-66c1-5b9cc1b6c81a",
_23
"revision": 13,
_23
"updated_at": 123456890,
_23
"user_guid": "USR-dfb1b536-692d-f172-88c6-643a2691b30c",
_23
"user_id": "0128372140"
_23
}
_23
}