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
      • Add or edit subscription
      • Get all profile subscriptions
      • Get all subscriptions from multiple profiles
      • Get profile subscription
      • Delete profile subscription
      • Restore deleted subscription
      • Suspend all subscriptions
      • Unsuspend all suspended 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
  • Subscriptions
  • Suspend all subscriptions
Documentation for version v74

Suspend all subscriptions

Description​

Changes profile subscription status from "subscribed" to "suspended".

Does not affect any other subscription status.

Request URL​

Method: POST

https://example.com/api/v1.1/subscriptions/suspend_all

Request example​

ParameterTypeExampleRequiredDescription
tokenstring"abcdefghijklmnqrstuvwxyz"YesAPI token
formatstring"json"NoResponse data format
By default – json.
db_idint1YesDatabase ID
channelint"email"NoChannel type
resource_idint1NoResource ID

If "channel" parameter is specified, all channel subscriptions for a database will be suspended.

If "resource_id" parameter is specified, all resource subscriptions for a database will be suspended.

If both parameters are specified - resource and channel subscriptions will be suspended.

Request example​

  • JSON
  • XML
{
"token": "abcdefghijklmnqrstuvwxyz",
"db_id": 1,
"channel": "email"
}
<xml>
<token>abcdefghijklmnqrstuvwxyz</token>
<db_id>1</db_id>
<channel>email</channel>
</xml>

Response example​

  • JSON
  • XML
{
"error": 0,
"error_text": "Successful operation",
"updated": 4080
}
<xml>
<error>0</error>
<error_text>Successful operation</error_text>
<updated>1344</updated>
</xml>

Response parameters​

ParameterTypeDescription
errorintError code
error_textstringError text
updatedintNumber of subscriptions suspended
Last updated on Mar 16, 2024
Previous
Restore deleted subscription
Next
Unsuspend all suspended subscriptions
  • Description
  • Request URL
  • Request example
  • Request example
  • Response example
  • Response parameters
© 2015 - 2025 Altcraft, LLC. All rights reserved.