Change Topic Subscriptions

You are here: Communications Cloud API v1 > Resources > Subscribers > Change Topic Subscriptions

Change Topic Subscriptions

PUT to /api/account/ACCOUNT_CODE/subscribers/ENCODED_SUBSCRIBER_ID/topics.xml

Your ACCOUNT_CODE can be found via the administrative interface.

The ENCODED_SUBSCRIBER_ID is the following information run through Base64 conversion:
- For email subscribers: email address.
- For wireless subscribers: a string consisting of country code, a plus (+) sign, and the (digit-only) phone number. Example: 1+5555555555
- The appropriately encoded ID will be returned in the <to-param> element of the output from the Create Subscriber method.

Example Input

Subscriber will have two topic subscriptions and will not receive notification of the update

<subscriber>
    <send-notifications type='boolean'>false</send-notifications>
      <topics type='array'>
        <topic>
          <code>####</code>
        </topic>
        <topic>
          <code>####</code>
        </topic>
    </topics>
  </subscriber>

All topic subscriptions for this subscriber will be removed and subscriber will be notified

<subscriber>
    <topics type='array' />
  </subscriber>

Elements

Output

A successful operation will have a 200 OK response status and an empty response body.

Troubleshooting

Reference subscriber error codes

Was this page helpful? Can't find what you need? Let us know

Open topic with navigation

<topics>	This field must include the type="array" attribute. Enter a list of topics for which you want the subscriber to be subscribed. The list of topics you include will completely replace the existing list of topic subscriptions currently set for the subscriber. To delete all topic subscriptions, include and empty topics array. You will enter any topic you want to include in each nested <topic> field.
<topic>	You can include multiple <topic> fields in your input; one for each topic for which the subscriber should be subscribed.
<code>	Enter the code of the topic for which the subscriber will receive updates. This field must be nested in a <topic> field, under the <topics> field.
<send-notifications>	This field requires a value of either True or False and the type="boolean" attribute. Set this field to true send an email notification to the subscriber that their record has been updated.