Skip to main content
Altcraft Docs LogoAltcraft Docs Logo
User guideDeveloper guideAdmin guide
Company siteHelp center
English
  • Русский
  • English
v74
  • v74
  • v73
  • v72
Login
  • User API documentation
  • API interaction
  • Matching
  • Profiles
    • Import profile
    • Update profile
    • Import multiple profiles
    • Update multiple profiles
    • Add multiple profiles
    • Add profile to database
    • Quick profile import
    • Import profile to RabbitMQ
    • Get profile data
    • Uploading profiles to a file
    • Suspend all database profiles
    • Unsuspend all profiles in a database
    • Delete profile
    • Subscription fields functional update
    • Database fields functional update
    • Merging multiple profiles
    • Unsubscribe profile from resource
    • Profile splitting
    • Subscriptions
    • Action history
    • Profile relations
    • Get data for multiple profiles
  • Databases
  • Resources
  • Segments
  • Suppression lists
  • Templates and fragments
  • Campaigns
  • Mailings
  • Automation scenarios
  • Loyalty Programs
  • Promo codes
  • Goals
  • Application push notifications
  • Market
  • Analytic reports
  • SendersDev
  • External datatables queries
  • Objects
  • Miscellaneous
  • Importing the API collection in Postman
  • List of API endpoints
  • SDK
  • Profiles
  • Unsubscribe profile from resource
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​

ParameterTypeExampleRequiredDescription
tokenstring"abcdefghijklmnqrstuvwxyz"YesAPI token
rtokenstring"abcdefghijklmnqrstuvwxyz"YesResource token
smidstring"abcdefghijklmnqrstuvwxyz"YesID of the sent message
categoriesarray["cat_to_unsub"]NoResource 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​

ParameterTypeDescription
errorintError code
error_textstringError text
profile_idstringProfile ID
Last updated on Mar 29, 2024
Previous
Merging multiple profiles
Next
Profile splitting
  • Description
  • Request URL
  • Request parameters
  • Request example
  • Response example
  • Response parameters
© 2015 - 2025 Altcraft, LLC. All rights reserved.