Push API
Event Payload
overview when an event, such as "sonic conference" (example) is added or edited in jomablue, a sns message is published to a jomablue owned sns topic, and the value of the ‘message’ key in the sns message will contain the following structure note that if category names change, or new categories are added or removed, the following is also generated and published this resource will always contain the latest category data for an event attributes a description of each attribute in the event payload is below resource type string must be ‘event’ generated at timestamp timestamp in the following format 2025 07 02t19 15 12 511z identifiers object id string a unique identifier alphanumeric (upper and lower case), hyphens, forward slash and underscores no whitespace data object name string alphanumeric (upper and lower case), special characters and whitespace start time timestamp timestamp in the following format 2025 07 02t19 15 12 511z end time timestamp timestamp in the following format 2025 07 02t19 15 12 511z short description string alphanumeric (upper and lower case), special characters and whitespace description string alphanumeric (upper and lower case), special characters and whitespace person count goal integer a positive number venue name string alphanumeric (upper and lower case), special characters and whitespace venue address string alphanumeric (upper and lower case), special characters and whitespace timezone string alphanumeric (upper and lower case), special characters and whitespace updated at timestamp timestamp in the following format 2025 07 02t19 15 12 511z created at timestamp timestamp in the following format 2025 07 02t19 15 12 511z metadata object keys must only contain alphanumeric (upper and lower case), hyphens and underscores no whitespace values can contain alphanumeric (upper and lower case), special characters and whitespace categories array categories \[] id string a unique identifier alphanumeric (upper and lower case), hyphens, forward slash and underscores no whitespace categories \[] name string alphanumeric (upper and lower case), special characters and whitespace sample payload a sample of an event payload is below event { "resource type" "event", "generated at" "2025 01 28t04 27 07 012624z", "identifiers" { "id" "acme/event/123" }, "data" { "name" "sonic conference 2025", "start time" "2024 12 25t12 00 00 000000z", "end time" "2024 12 26t12 00 00 000000z", "short description" "an awesome education event", "description" "for the 10th year we are running the awesome educatio ", "person count goal" 3000, "venue name" "icc sydney", "venue address" "14 darling dr, sydney nsw 2000", "timezone" "australia/sydney", "updated at" "2025 01 28t04 27 07 012624z", "created at" "2025 01 28t04 27 07 012624z", "metadata" { "text" "anything", "selector" "option2", "predefined" "predefinedvalue" }, "categories" \[ { "id" "acme/category/1231", "name" "delegate" }, { "id" "acme/category/1232", "name" "vip" }, { "id" "acme/category/1233", "name" "crew" }, { "id" "acme/category/1234", "name" "jomablue support" } ] } } triggering an event payload an example of how to trigger this payload log in to your instance of jomablue select an event navigate to (event) settings make a change to the event name or venue address, then press save