You can also add a new participant to an acquisition campaign using the public API.
Adding a new person to your database
When you send this
POST
, an existing unsubscribed person record will be searched for. If found, it will be updated with any additional information you provide. If no person record is found, a new record will be created.Note that you do not need to add a person record before making this call.
Request
The request of this call follows the formatting of a person entity. However, it is important to note that a person entity does not have to be created before you make an Add a participant call. If the unique identifier in your Add a participant call does not match any person record, a new person record will be created and added to your mobile database.
Request Notes
- At a minimum, one of the following must be specified:
person_key
,external_person_id
,person_id
, orMDN
. - Any fields specified for the person will be updated with the new values.
- Any fields whose values are set to
Null
will be removed from the person. - Any fields completely omitted will be ignored, and any existing values will remain.
- These changes will only be performed if a 2xx HTTP response is returned by the API call.
- If you are using custom fields, they must first be created in the Vibes Platform prior to sending via API.
Response
The return data will be the acquisition campaign participation object.