Last Updated: Friday, November 22, 2019
Overview
The Subscription entity contains the information and metadata for a Person's Subscription to a Subscription List.
Topics in this Section
Subscription Entity
The following shows the JSON representation of a Subscription entity within the APIs.
{ "person":{ "id":"ABC123", "url":"/companies/:company_key/mobiledb/persons/:person_id" }, "subscription_list":{ "id":"1234", "url":"/companies/:company_key/mobiledb/subscription_lists/:id" }, "opt_in_date":"2017-01-15T15:34Z", "url":"/companies/:company_key/mobiledb/persons/:person_id/subscriptions/:subscription_list_id" }
Elements
Data Element | Type | Description |
---|---|---|
person | Object | Person reference information for the Subscription. |
subscription_list | Object | Subscription List object reference information for the Subscription. |
opt_in_date | Timestamp | Time reference of when the Subscription was entered. It should be in the ISO 8601 format - for example: 2017-01-15T15:34Z. |
opt_out_date | Timestamp | Time reference of when the Subscription was ended. It should be in the ISO 8601 format - for example: 2017-01-15T15:34Z. |
opt_out_reason | String | The reason why the person was opted-out. The reason will be one of: “user_opt_out”, “disconnect”, “list_archived”, “bulk_opt_out”, “failed_at_carrier”, “obsolete_carrier”, “platform_opt_out”, “keyword_opt_out”, “api_opt_out”, “button_opt_out”. |
url | String | A reference URL to the existing object, as a relative URL to the existing domain. |
2 Comments
Steven Mastandrea
Should we use opt_in_date, or start date?
Sam Benediktson