Tags

Create a tag

Creates a new tag, either personal or scoped to a team. A team type=post tag requires posts.create or posts.edit; a team type=inbox tag requires inbox.manage.

post/tags

Request

  • Base URL: https://socialbu.com/api/v1
  • URL: https://socialbu.com/api/v1/tags
  • Auth: HTTP bearer

Request body

namestring required
team_idinteger

Team ID to create the tag under. Omit to create a personal tag.

colorstring nullable

Hex color. Any valid 6-digit hex color is accepted. Omit for the default (uncolored) look.

type'post' | 'inbox' required

Whether this is a post tag or an inbox tag. Tags are no longer shared between the two.

Response

Tag created successfully.

messagestring
tagstring

The created tag's name.

idinteger

The created tag's id.

colorstring nullable
can_manageboolean

Whether the requesting user can also rename/delete this tag — see the Tag schema. A create-only team member gets false even for a tag they just created.

Changes

No recorded changes to this operation across all 1 revision of this API.