Overview

Permanently delete a subscription using its subscription ID. This operation removes the subscription from the system and halts all future notifications or alerts related to it.

Quickstart

Follow these two steps to make a request and recognize a successful response.

curl --request DELETE \
  --url https://uapi.demandbase.com/data/b2b/v1/subscriptions/287ea0c8-99de-4f0c-addc-097f78b48ba6 \
  --header "Authorization: Bearer $DB_API_KEY" \
  --header "Accept: application/json"

{
  "subscriptionId": "63914a27-a5ca-4fdf-80b0-ffc985f53c14",
  "message": "Subscription deleted successfully"
}

Request anatomy

Build the request from the method, path, parameters, and payload described below.

Parameters

Request body

This endpoint does not define a JSON request body.

Response anatomy

The endpoint returns 200 for the documented success case. Subscription was deleted successfully.

The response schema does not enumerate fields; inspect the example response and status code.

Rules

• Use DELETE with the path /subscriptions/{subscriptionId}.
• Required inputs: subscriptionId.
• Authenticate every request with a valid Demandbase access token.
• This endpoint does not require a JSON request body.

Filters

The published schema exposes the following endpoint inputs. Use the location column to place each value correctly.

Errors

Handle non-success responses explicitly so your integration can report actionable failures.

Next steps

Back to top