Last Updated: Friday, November 22, 2019
Get Push Device
The following will retrieve a push device or list of push devices by its person_id, external_person_id, or vibes_device_id.
There is no Request JSON with a GET.
A push device is only added or updated via the Push SDK itself and not via API calls.
Associate Push Device to Person
This call assigns a given device to a specific Person as defined by their person_key or external_person_id. If both are supplied, the person_key will be used and the external_person_id will be ignored.
- If a person_key is supplied, and a Person with that person_key does not exist, that will result in an error.
- If an external_person_id is supplied and a Person with that external_person_id does not exist, then the external_person_id will be assigned to the Person currently associated with the device.
- If the indicated Person exists and the device is not already associated with them, it will be moved to be associated with them.
- If the indicated Person is already associated with the device, then nothing will be done and a success response will be returned.
To make this API call, you must have valid Basic Auth credentials for a user who has public_api:user on the company that the app belongs to, or has the public_api:admin role.
Response – HTTP Status Codes
200 - OK
The device was successfully assigned to the given Person.
404 - Not Found
The vibes_device_id, or the person_key (if provided) could not be found.
422 - Unprocessible Entity
The requested assignment could not be completed. Reason will be stated in the response body.
Successful Response Body
The call will return the newly associated Person, which will be a Person as described in the Person API Methods topic of the Vibes Platform APIs documentation Wiki, using the V2 format.
Error Response Body
In the case of an error, the standard public API error response body will be used.
After the vibes_device_id and the external_device_id are securely associated, the Vibes Platform will be able to use the Person customer fields to target messaging.