Create Tag

Creates a new tag with the specified properties.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Limitations:

  • Maximum of 20 tags per scope (user or affiliate)
  • Only affiliate admins can create affiliate-wide tags
  • Tag names must be unique within the same scope

Important Notes:

  • The owner id and targetModel are automatically set by the backend based on the authenticated user
  • If no scope is provided, it defaults to a user-scoped tag
  • The backend completely overwrites the scope object with the correct structure

Error Responses:

  • 400: Invalid parameters or maximum tags limit reached
  • 401: Authentication required
  • 403: Insufficient permissions for affiliate-wide tags
  • 409: Tag name already exists in scope
Body Params
string
required

Tag name (max 100 characters)

string

Tag description (max 500 characters)

string

Tag color in hex format (e.g., "#FF5733")

scope
object

Tag scope configuration

Responses

400

Bad Request - Invalid parameters or maximum tags limit reached

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json