Page History
Last Updated:
Lastupdatedate |
---|
Livesearch | ||||
---|---|---|---|---|
|
The following methods describe how and why Person Added and Person Updated callback events are used, including examples.
Anchor | ||||
---|---|---|---|---|
|
The Person Added callback event is triggered when a new Person record is added to your Mobile Database. The Person object represents the new state of the Person added.
Callback Body
Note |
---|
Note: MDN formats in callback events are determined by the API version used when creating and altering the callbacks. If Version 2 is used, MDNs will be represented in the E.164 international format. Otherwise, MDNs will be represented without a country code. |
Code Block |
---|
{
"event_id":"AB234SDFD234",
"callback_type":"person_added",
"event_type":"person_added", //deprecated
"event_date":"2017-03-15T15:42:23Z",
"delivery_attempt":"1",
"person":{
"person_id": "12344566",
"external_person_id":"542342",
"mobile_phone":{
"mdn":"+12995551234",
"carrier_code":"104"
},
"timezone": "US/Central",
"timezone_source: "area_code",
"custom_fields":{
"first_name":"Steve",
"birthdate":"1950-12-01T00:00:00Z",
"rewards_id":"543557654",
"favorite_stores":[
{
"id":"4",
"name":"My Hardware Store",
"option_key":"my_hardware_store"
},
{
"id":"12",
"name":"Local Grocery",
"option_key":"local_grocery"
}
]
},
"created_at":"2017-01-15T14:30Z",
"updated_at":"2017-02-18T19:30Z",
"url":"/companies/:company_key/mobiledb/persons/:person_id"
}
}
|
Anchor | ||||
---|---|---|---|---|
|
The Person Updated callback event is triggered when an existing Person record has been modified in your Mobile Database. This includes scenarios where a Person was requested to be added, but an existing Person was located and matched because they already interacted with the platform (either by MDN or external_person_id).
The Person object represents the complete updated state of the Person.
Callback Body
Note |
---|
Note: MDN formats in callback events are determined by the API version used when creating and altering the callbacks. If Version 2 is used, MDNs will be represented in the E.164 international format. Otherwise, MDNs will be represented without a country code. |
Code Block |
---|
{
"event_id":"AB234SDFD234",
"callback_type":"person_updated",
"event_type":"person_updated", //deprecated
"event_date":"2017-03-15T15:42:23Z",
"delivery_attempt":"1",
"person":{
"person_id": "12344566",
"external_person_id":"542342",
"mobile_phone":{
"mdn":"+12995551234",
"carrier_code":"104"
},
"timezone": "US/Central",
"timezone_source: "area_code",
"custom_fields":{
"first_name":"Steve",
"birthdate":"1950-12-01T00:00:00Z",
"rewards_id":"543557654",
"favorite_stores":[
{
"id":"4",
"name":"My Hardware Store"
},
{
"id":"12",
"name":"Local Grocery",
"option_key":"local_grocery"
}
]
},
"created_at":"2017-01-15T14:30Z",
"updated_at":"2017-02-18T19:30Z",
"url":"/companies/:company_key/mobiledb/persons/:person_id"
}
}
|
Additional Resources
- For information on how to register your endpoint to receive callbacks, see Callback Configuration
- Client Certificate Authentication for Callbacks from the Vibes Platform