WIwistia
Tags

Create Tags

Changed on

Creates a new tag.

Requires api token with one of the following permissions

Read, update & delete anything

Tokens with the "Act with a team member's permissions" permission (all:delegate_to_contact_permissions scope) can also be used. Requests made with such a token are authorized using the permissions of the contact assigned to the token.

An expiring access token created with the all:delegate_to_contact_permissions scope and an authorization granting the manage-tags permission on the account can also be used.

post/tags

Request

  • Base URL
    https://api.wistia.com/modern
  • URL
    https://api.wistia.com/modern/tags
  • Auth
    HTTP bearer

Headers

X-Wistia-API-Versionstring required

Request body

namestring required

The tag name. Stored lowercased with whitespace squished, 50 characters max, and must not already exist on the account.

Response

Tag created successfully

namestring

The tag's display name.

taggings_countinteger

The number of different medias that have been associated with this tag.

created_atstring date-time

The date that the tag was originally created.

updated_atstring date-time

The date that the tag was last updated.

cursorstring nullable

A cursor for stable pagination based on current sort_by order. You can pass this to cursor[before] or cursor[after] as a parameter to fetch the records before or after this record in the same sort order. This is only populated if records were fetched with cursor[enabled], or cursor[before] or cursor[after].

Example response

{
  "name": "My tag Title",
  "taggings_count": 2,
  "created_at": "2010-08-13T18:47:39+00:00",
  "updated_at": "2010-08-19T21:47:00+00:00"
}

Changes