Push API
Person Payload
overview when a person is added to an event, an sns message is published to a jomablue owned topic and the value of the sns ‘message’ will contain the following structure this is also published if any edits to the person are made, or the person checks in to an event (has their badge printed) attributes a description of each attribute in the person payload can be found below resource type string must be ‘person’ generated at timestamp timestamp in the following format 2025 07 02t19 15 12 511z context object event id string a unique identifier alphanumeric (upper and lower case), hyphens, forward slash and underscores no whitespace event name string alphanumeric (upper and lower case), special characters and whitespace event metadata object keys must only contain alphanumeric (upper and lower case), hyphens, forward slash and underscores no whitespace values can contain alphanumeric (upper and lower case), special characters and whitespace identifiers object first name string alphanumeric (upper and lower case), special characters and whitespace last name string alphanumeric (upper and lower case), special characters and whitespace email string a correctly formatted email address can be empty phone string alphanumeric (upper and lower case), special characters and whitespace can be empty company string alphanumeric (upper and lower case), special characters and whitespace can be empty id string a unique identifier alphanumeric (upper and lower case), hyphens, forward slash and underscores no whitespace organisation uid string a unique identifier provided from external systems to jomablue (eg a salesforce campaign id) alphanumeric (upper and lower case), hyphens, forward slash and underscores data object job title string alphanumeric (upper and lower case), special characters and whitespace can be empty cancelled boolean true or false checked in boolean true or false first check in timestamp timestamp in the following format 2025 07 02t19 15 12 511z import type string alphanumeric (upper and lower case), hyphens, forward slash and underscores no 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 custom fields array may be empty custom fields \[] key string alphanumeric (upper and lower case), hyphens, forward slash and underscores no whitespace custom fields \[] value string alphanumeric (upper and lower case), special characters and whitespace categories array categories \[] id string alphanumeric (upper and lower case), hyphens, forward slash and underscores no whitespace categories \[] name string sample payload a sample person payload can be found below person { "resource type" "person", "generated at" "2025 01 28t04 45 34 089026z", "context" { "event id" "acme/event/123", "event name" "sonic conference 2025", "event metadata" { "text" "anything", "selector" "option2", "predefined" "predefinedvalue" } }, "identifiers" { "first name" "catherine", "last name" "lebsack", "email" "catherine lebsack\@example com", "phone" "+61491570006", "company" "barrows, heaney and watsica", "id" "acme/event person/123", "organisation uid" "4ab9ecb4 91cd 34ba 928e b6d929b81a1c" }, "data" { "job title" "ceo", "cancelled" false, "checked in" false, "first check in" null, "import type" "import", "updated at" "2025 01 28t04 45 34 089026z", "created at" "2025 01 28t04 45 34 089026z", "custom fields" \[ { "key" "dietary requirements", "value" "none" }, { "key" "company size", "value" "500 999" }, { "key" "primary interest", "value" "technology" } ], "categories" \[ { "id" "acme/category/1231", "name" "delegate" }, { "id" "acme/category/1232", "name" "vip" } ] } } triggering a person payload an example of how to trigger this payload log in to your instance of jomablue select an event (if prompted) navigate to people add a new person or edit and existing and press save