POST https://api.usecommune.com/newsletters/{newsletter}/tags Production. There is no separate sandbox host.

Create a tag

Makes a new segment of this newsletter's audience. Needs audience: write, and is a write.

The tag starts empty. Nobody holds it and no article is addressed to it, so creating one grants nobody access to anything. People are put in it by Apply a tag to a subscriber (POST /subscribers/{subscriber}/tags/{tag}), or by Apply a tag to many subscribers (POST /tags/{tag}/subscribers) for a list, which are the calls that decide access, and an article is addressed to it when it is sent.

name has to be unique among this newsletter's live tags. A name a live tag already has answers 422. A name freed by a retirement is available again, and taking it does not disturb the retired tag, which goes on resolving the audience of the articles it was addressed to.

Publishes no event.

Path parameters

  • string Required

Request Headers

  • string Required
  • string

Body

  • string Required
POST /newsletters/{newsletter}/tags
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-createtag

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.