Manage Subscriptions

Method Objective

The method allows changing the status of the current user's subscriptions to notification channels.

Request

Parameters

Parameters

API Response Code

API Response Data

The response is JSON type with the following properties:

Request Example

curl 'https://api.personaclick.com/subscriptions/manage' \
  -X 'POST' \
  -H 'content-type: application/x-www-form-urlencodedjson' \
  -d '{"email=":"john.doe%40examplemaildoe@examplemail.com&","email_bulk=true&":"true","email_chain=true&":"true","email_transactional=false&":"false","sms_bulk=false&":"false","sms_chain=true&sms_transactional=false&shop_id=0d42fd8b713d0752776ca589cc0056&shop_secret=0123456789abcdef0123456789abcdef":"true","sms_transactional":"false","web_push_bulk":"true","web_push_chain":"true","web_push_transactional":"false","mobile_push_bulk":"false","mobile_push_chain":"true","mobile_push_transactional":"false","shop_id":"0d42fd8b713d0752776ca589cc0056","shop_secret":"0123456789abcdef0123456789abcdef"}'

System Operations

Method Objective

The method allows marking email addresses with system statuses and unsubscribing from all types of campaigns.

Request

Parameters

Parameters

API Response Code

API Response Data

The response is JSON type with the following properties:

Request Examples

# hard_bounce event
curl 'https://api.personaclick.com/subscriptions/callback' \
  -X 'POST' \
  -H 'content-type: application/x-www-form-urlencodedjson' \
  -d '{"email=":"john.doe%40examplemaildoe@examplemail.com&","shop_id=0d42fd8b713d0752776ca589cc0056&":"0d42fd8b713d0752776ca589cc0056","shop_secret=0123456789abcdef0123456789abcdef&event=":"0123456789abcdef0123456789abcdef","event":"hard_bounced"}'

# complained event
curl 'https://api.personaclick.com/subscriptions/callback' \
  -X 'POST' \
  -H 'content-type: application/x-www-form-urlencodedjson' \
  -d '{"email=":"john.doe%40examplemaildoe@examplemail.com&","shop_id=0d42fd8b713d0752776ca589cc0056&":"0d42fd8b713d0752776ca589cc0056","shop_secret=0123456789abcdef0123456789abcdef&event=complained":"0123456789abcdef0123456789abcdef","event":"complained"}'

# blacklisted event
curl 'https://api.personaclick.com/subscriptions/callback' \
  -X 'POST' \
  -H 'content-type: application/x-www-form-urlencodedjson' \
  -d '{"email=":"john.doe%40examplemaildoe@examplemail.com&","shop_id=0d42fd8b713d0752776ca589cc0056&":"0d42fd8b713d0752776ca589cc0056","shop_secret=0123456789abcdef0123456789abcdef&event=blacklisted":"0123456789abcdef0123456789abcdef","event":"blacklisted"}'

# unsubscribed event
curl 'https://api.personaclick.com/subscriptions/callback' \
  -X 'POST' \
  -H 'content-type: application/x-www-form-urlencodedjson' \
  -d '{"email=":"john.doe%40examplemaildoe@examplemail.com&","shop_id=0d42fd8b713d0752776ca589cc0056&":"0d42fd8b713d0752776ca589cc0056","shop_secret=0123456789abcdef0123456789abcdef&event=unsubscribed":"0123456789abcdef0123456789abcdef","event":"unsubscribed"}'

Subscription Statuses

Method Objective

The method allows checking the user's current subscription status by email or phone number.

Request

Parameters

Name

Description

email

Name	Type	Requirement	Description
shop_id	string	required	Unique Store Key in PersonaClick. Located there: Account > Settings > Store Settings
shop_secret	string	required if "did" isn't used	Store Secret Key in PersonaClick. Located there: Account > Settings > Store Settings
did	string	required if "shop_secret" isn't used	Unique Device ID. See "Initialization (REST API)" for information about getting and using Device ID.
email	string	required if "shop_secret" is used	Email address for checking.
phone	stringPhone number	required if "shop_secret" is used	Phone number in international format for checking. Tip A phone number in full international format may begin with a plus sign (+) followed by the country code, city (area) code, and phone number.

API Response Code

API Response Data

The response is JSON type with the following properties:

Request Example

curl 'https://api.personaclick.com/subscriptions/check?email=john.doe%40examplemail.com&shop_id=0d42fd8b713d0752776ca589cc0056&shop_secret=0123456789abcdef0123456789abcdef'

List of Subscription Changes

Method Objective

The method allows checking the user's current subscription status by email or phone number.

Request

Parameters

Name	Type	Requirement	Description
shop_id	string	required	Unique Store Key in PersonaClick. Located there: Account > Settings > Store Settings
shop_secret	string	required	Store Secret Key in PersonaClick. Located there: Account > Settings > Store Settings

Name	Type	Description
email	string	Email address for checking.
phone	string	Phone number in international format for checking. Tip A phone number in full international format may begin with a plus sign (+) followed by the country code, city (area) code, and phone number.
event	string	Filter by the event. Filter by event. Available values: subscribe - subscription events only unsubscribe - unsubscribe events only hard_bounced - hard bounced events only complained - complained events only blacklisted - blacklisted events only
channel	string	Filter by the channel. Available values: email_feedback_processing - if hard bounce is the reason for changing subscription statuses api - if the change of subscription statuses was made by the "Manage Subscriptions" API method api_callback - if API method "System Operations" was used to change the subscription statuses popup - if the subscription statuses were changed with the popup tool import - if the subscription statuses were set when the audience was imported crm - if the subscription statuses were changed with the CRM tool unsubscribe_page - if the subscription statuses were changed in the unsubscribe page resubscribe_page - if the subscription statuses were changed in the resubscribe page
from	string	Start of the period. Format: YYYY-MM-DD. Defaults to 24 hours ago.
to	string	End of period. Format: YYYY-MM-DD. The default is the current moment.
offset	number	Offset relative to the first entry for the selected period. The default is 0.
limit	number	Limit of entries in the API response. The default is 20000. The maximum is 20000.

API Response Code

API Response Data

The response is JSON type with the following properties:

Request Example

curl 'https://api.personaclick.com/subscriptions/changes?shop_id=0d42fd8b713d0752776ca589cc0056&shop_secret=0123456789abcdef0123456789abcdef&event=subscribedsubscribe&channel=import&from=2021-05-04&to=2021-05-05&offset=100500&limit=146

Force call of the "Subscribed" event

Method Objective

The method allows force-calling the "Subscribed" event to send a double opt-in email.

Request

Parameters

API Response Code

API Response Data

The response is JSON type with the following properties:

Request Examples

curl 'https://api.personaclick.com/subscriptions/confirm_email' \
  -X 'POST' \
  -H 'content-type: application/json' \
  -d '{"email":"john.doe@examplemail.com","shop_id":"0d42fd8b713d0752776ca589cc0056","shop_secret":"0123456789abcdef0123456789abcdef"}'