POST

Create Tag


Creates a new tag with the provided label if a tag with the same label doesn't already exist.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Blog
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/blog/v3/tags

Body Params
labelstringRequiredminLength 1maxLength 200

Tag label. The label for each tag in a blog must be unique.


languagestringformat LANGUAGE_TAG

Tag language.

2-or-4-letter language code in IETF BCP 47 language tag format.


slugstringmaxLength 100

Preferred tag slug. For example, 'tag-slug'.


fieldsetsArray <string>maxItems 10

List of additional tag fields to include in the response. For example, use the URL fieldset to retrieve the url field in the response in addition to the tag's base fields. Base fields don’t include any of the supported fieldset values. By default only the tag's base fields are returned.

Response Object
tagTag

Tag info.

Create Tag Example 1
Request
cURL
curl -X POST \ 'https://www.wixapis.com/blog/v3/tags/' \ -H 'Content-Type: application/json' \ -H 'Authorization: <AUTH>' -d '{ "label": "vacation", "language": "en" }'
Response
JSON
{ "tag": { "id": "0c20a033-bcdb-42af-a793-84a83f4a5bf1", "label": "vacation", "slug": "vacation", "createdDate": "2021-09-08T11:11:15.949Z", "updatedDate": "2021-09-08T11:11:15.949Z", "publicationCount": 0, "postCount": 0, "language": "en" } }
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Event TriggersThis method triggers the following events:
Did this help?