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:
{
"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": "[email protected]",
"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