Tags

Create tag

Creates a new organization tag.

post/tags

Request

  • Base URL: https://viral.app/api/v1
  • URL: https://viral.app/api/v1/tags
  • Auth: API key in header x-api-key

Request body

namestring required
descriptionstring nullable
colorstring nullable

Tag color in hex format

visibleToCreatorsboolean

Whether creators see this tag's name where it decides their pay (campaign payout conditions). When false, creators see “videos the brand selects” instead. Country and continent tags are always visible.

Example request

{
  "name": "ugc",
  "description": "User-generated content",
  "color": "#2563EB",
  "visibleToCreators": true
}

Response

OK

idstring required

Organization tag ID with orgtag_ prefix

namestring required
descriptionstring nullable required
colorstring nullable required

Tag color in hex format

visibleToCreatorsboolean required

Whether creators see this tag's name where it decides their pay (campaign payout conditions). When false, creators see “videos the brand selects” instead. Country and continent tags are always visible.

createdAtstring date-time required
updatedAtstring date-time required

Example response

{
  "color": "#2563EB"
}

Changes

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