DocsBuilding AppsInstalling IntercomAPI & Webhook ReferenceCanvas Kit Reference
DocsApp StoreForumBlogYour Apps

Detach a contact from a subscription

Example Request & Response

$ curl https://api.intercom.io/contacts/<contact_id>/subscriptions/<id> \
-X DELETE \
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept:application/json'
HTTP/1.1 200 OK
{
  "type": "subscription",
  "id": "1",
  "state": "live",
  "default_translation": {
    "name": "Announcements",
    "description": "Offers, product and feature announcements",
    "locale": "en"
  },
  "translations": [
    {
      "name": "Ankündigungen",
      "description": "Angebote, Produkt- und Funktionsankündigungen",
      "locale": "de"
    },
    {
      "name": "Announcements",
      "description": "Offers, product and feature announcements",
      "locale": "en"
    }
  ]
  "consent_type": "opt_out"
}
Example Errors

HTTP/1.1 404 NOT FOUND
{
  "type": "error.list",
  "request_id": "9a3d0816-9707-4598-977e-c009ba630148",
  "errors": [
    {
      "code": "not_found",
      "message": "User Not Found"
    }
  ]
}
HTTP/1.1 404 NOT FOUND
{
  "type": "error.list",
  "request_id": "060932ab-ab9d-4f89-88f3-d0152d005873",
  "errors": [
    {
      "code": "not_found",
      "message": "Resource Not Found"
    }
  ]
}

You can detach a subscription for a single contact.

Request Path Parameter

Attribute

Type

Description

contact_id

String

The unique identifier for the contact which is given by Intercom

id

String

The unique identifier for the subscription type which is given by Intercom

Response

This will return a Subscription Type model for the subscription type that was removed from the contact.