v51

latestOpenAPI 3.0.1MITraw.githubusercontent.com2026-08-01150230854.3 KB

Subscription Types

Contacts

Remove subscription from a contact

You can remove a specific subscription from a contact. This will return a subscription type model for the subscription type that was removed from the contact.

delete/contacts/{contact_id}/subscriptions/{subscription_id}

Path parameters

contact_idstring required

The unique identifier for the contact which is given by Intercom

subscription_idstring required

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

Headers

Intercom-Version'1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14'

Intercom API version.</br>By default, it's equal to the version set in the app package.

Example:2.14

Response

Successful

typestring

The type of the object - subscription

idstring

The unique identifier representing the subscription type.

state'live' | 'draft' | 'archived'

The state of the subscription type.

consent_type'opt_out' | 'opt_in'

Describes the type of consent.

content_typesstring[]

The message types that this subscription supports - can contain email or sms_message.

Example response

{
  "type": "subscription",
  "id": "123456",
  "state": "live",
  "default_translation": {
    "name": "Announcements",
    "description": "Offers, product and feature announcements",
    "locale": "en"
  },
  "translations": [
    {
      "name": "Announcements",
      "description": "Offers, product and feature announcements",
      "locale": "en"
    }
  ],
  "consent_type": "opt_in",
  "content_types": [
    "email"
  ]
}