Skip to end of metadata
Go to start of metadata

Last Updated: Friday, July 26, 2019



The following methods describe how and why Subscription Added and Subscription Removed callback events are used, including examples.

Subscription Added Callback

This callback event is triggered when a new Subscription has been added to a Person. The Subscription object contains the reference to the Subscription that was added.

Callback Body

{
   "event_id":"AB234SDFD234",
   "event_type":"subscription_added",
   "event_date":"2017-03-15T15:42:23Z",
   "subscription":{
      "person":{
         "id":"ABC123",
         "external_id":"ex1234",
         "url":"/companies/:company_key/mobiledb/persons/ABC123"
      },
      "subscription_list":{
         "id":"1234",
         "url":"/companies/:company_key/mobiledb/subscription_lists/1234"
      },
      "opt_in_date":"2017-01-15T15:34:52Z"
   }
}

Subscription Removed Callback

This callback event is triggered whenever a Subscription has been removed from a Person. The Subscription object contains reference to the Subscription that was removed.

Callback Body

{
   "event_id":"AB234SDFD234",
   "event_type":"subscription_removed",
   "event_date":"2017-03-15T15:42:23Z",
   "subscription":{
      "person":{
         "id":"ABC123",
         "external_id":"ex1234",
         "url":"/companies/:company_key/mobiledb/persons/ABC123"
      },
      "subscription_list":{
         "id":"1234",
         "url":"/companies/:company_key/mobiledb/subscription_lists/1234"
      },
      "opt_in_date":"2017-01-15T15:34:52Z",
      "opt_out_date":"2017-02-18T15:34:52+0000",
      "opt_out_reason":"user_opt_out"
   }
}

The opt_out_reason values for the disconnect are as follows.

  • user_opt_out
  • disconnect
  • list_archived
  • bulk_opt_out
  • failed_at_carrier
  • obsolete_carrier
Note: Vibes may add additional opt_out_reason options in the future.
  • No labels

2 Comments

  1. Not sure about these, and the IDs specifically, since the initial thought would be to hide the subscription history. Might make it tough to avoid multiple add/deletes, though. Maybe have them verify opt-in?

  2.       "acquisition_campaign":{
             "id":"2342312",
             "url":"/companies/:id/campaigns/acquisition/2342312"
          },