Documentation for version v74
Unsubscribe profile from resource
Description
Sends the information of the profile unsubscribtion to the platform. The subscription status changes to "Unsubscribed". Also this method allows to unsubscribe a profile from certain categories of resource.
Request URL
Method: POST
https://example.com/api/v1.1/profiles/message_unsub
Request parameters
| Parameter | Type | Example | Required | Description |
|---|---|---|---|---|
| token | string | "abcdefghijklmnqrstuvwxyz" | Yes | API token |
| rtoken | string | "abcdefghijklmnqrstuvwxyz" | Yes | Resource token |
| smid | string | "abcdefghijklmnqrstuvwxyz" | Yes | ID of the sent message |
| categories | array | ["cat_to_unsub"] | No | Resource category |
Request example
- JSON
- XML
{
"token": "abcdefghijklmnqrstuvwxyz",
"rtoken":"2fHLS9YR9daS-a90b371eecc2952f",
"smid": "fGmXiWU9Y4NSIpCwl4QG6QXAAAQEQsQQQEQEAABCRA",
"categories": ["cat_to_unsub"]
}
<xml>
<token>abcdefghijklmnqrstuvwxyz</token>
<rtoken>2fHLS9YR9daS-a90b371eecc2952f</rtoken>
<smid>fGmXiWU9Y4NSIpCwl4QG6QXAAAQEQsQQQEQEAABCRA</smid>
<categories>cat_to_unsub</categories>
</xml>
Response example
- JSON
- XML
{
"error": 0,
"error_text": "Successful operation",
"profile_id": "658997338e8f4032d92fd56d"
}
<xml>
<error>0</error>
<error_text>Successful operation</error_text>
<profile_id>658997338e8f4032d92fd56d</profile_id>
</xml>
Response parameters
| Parameter | Type | Description |
|---|---|---|
| error | int | Error code |
| error_text | string | Error text |
| profile_id | string | Profile ID |