Endorsal icon

Endorsal

Manage testimonials and tags in Endorsal

Actions15

Tag → Create

AI-generated

Summary

Create a new tag in the Endorsal system scoped to the default property associated with the API key. If a tag with the specified name already exists for that property, the existing tag is returned instead of creating a duplicate.

Inputs

  • Name (required) — The name of the tag to create.
  • Type — The tag type, either 'Tag' (default) or 'Product'.
  • Additional Fields — Optional additional properties for the tag, including Description, and for 'Product' type tags, Image URL, Link, and SKU (external product ID).

Output shape

a single tag object

The output returns the created or existing tag's data. If the tag already exists, the output includes an 'existing: true' field to indicate that no new tag was created. The tag is created or returned for the property scoped by the API key in use. To create a tag for a different property, use an API key scoped to that property.

Examples

Example 1: Creating a new generic tag named 'Featured'

Set 'Name' to 'Featured', 'Type' to 'Tag' (default), and optionally add a description in 'Additional Fields'.

Example 2: Creating a product tag with image and SKU

Set 'Name' and 'Type' to 'Product', and specify 'Image URL', 'Link', and 'SKU' under 'Additional Fields'.

Links

Discussion