Skip to main content

DeletePreferencesByEmail

Delete subscriber preferences from contacts according to email address.

POST /api/v3/userinfo/delete_preferences_by_email

Request parameters

For more information on the query parameters, see Query parameters.

AttributeData typeRemarksDescription
emailstringrequiredEmail
modify_tsbigintrequiredTimestamp of deletion (in milliseconds)
preferences[]stringrequiredAttribute to determine a contact's subscription groups, which can be used to classify subscribers based on interests and subscriber preferences.
Used in user segmentation, for sending targeted emails to users with specific subscriber preferences:
  • Ensure the subscriber preferences have been created in SmartLink > Contacts > Preferences, else the deletion will fail.
  • Up to 20 preferences can be deleted at a time.

Request sample

curl --request POST "https://openapi.smartlink.intlgame.com/api/v3/userinfo/delete_preferences_by_email?gameid=${GAME_ID}&seq=${YOUR_RANDOM_STRING}&sig=${SIGNATURE}&ts=${TS}" \
--header 'Content-Type: application/json' \
--data-raw '{
"email": "545058834@qq.com",
"modify_ts": 1691225447577,
"preferences": [
"option3"
]
}'

Response parameters

AttributeData typeDescription
codeintReturn code
msgstringReturn message

Response sample

{
"code": 0,
"msg": "Success",
"seq": "{YOUR_RANDOM_STRING}"
}