POST https://api.usecommune.comsubscriber.tagged Production. There is no separate sandbox host.

Subscriber tag added or removed

A tag was added to or taken off a subscriber. data.direction says which: assigned when the tag was put on, removed when it was taken off.

One topic carries both directions, so subscribing once is enough to mirror a segment's membership.

Applying a tag is idempotent, so re-applying one the subscriber already holds produces no second event. A tag is not a label: it scopes who an article is sent to and who may read it, so treat these as access changes.

Retiring the tag itself has no topic. It retires the tag for everyone at once rather than removing one assignment, so it does not fan out into one event per subscriber here.

Delivered as a single HTTPS POST to the consumer's registered endpoint, with the message as the JSON request body. Respond 2xx to acknowledge. Anything else, or a timeout, is retried with backoff, so acknowledge fast and do the work afterwards.

Request Headers

  • string Required
  • string(uuid) Required
  • string Required
  • string Required
  • string(date-time) Required
  • integer

Body

A subscriber tag was applied or taken off.

  • string(uuid) Required
  • string Required
  • string Required
  • string(date-time) Required
  • string(uuid) | null Required
  • string | null Required
POST subscriber.tagged
Loading...

Share your request

Use this link to easily share a pre-filled request of this operation. Everything you filled will be shared apart from the authentication fields.

Request URL

https://api-reference.usecommune.dev/explorer/operation/operation-onsubscribertagged

Send a delete request

It looks like you’re about to send a DELETE request to this API. This type of request carries a risk of permanent and irreversible data loss.

Are you sure you want to continue?
Response
Waiting for a request to be sent.