POST /hub/v1/objects/{objectTypeName}/tags/

Overview

You can add tags via the API to Marketing Cloud to help identify and categorize different objects. An object can have multiple tags, and a tag can be associated with multiple objects. This resource creates an association for each tag/object pair. For example, if the payload includes 10 tags and 20 object IDs, the API call creates 200 associations.

URL Parameters

NameTypeDescription
objectTypeNamestringRequiredDesignates the type of object to assign tags to. Possible values include:
  • campaign - adds tags to a campaign
  • InteractionStudio.DefinitionInfo - adds tags to a journey
  • media - adds tags to a media asset

JSON Parameters

NameTypeDescription
ObjectIdsstringRequiredThe ObjectIds are the unique IDs for the objects. Each ObjectId is associated with each tag specified in the payload. For Journey Builder, the ObjectIds are the are the OriginalDefinitionId of the journeys.
TagNamesstringRequiredName of the tag to delete. If a tag name is specified that does not exist, the tag will be created. Tag names for journeys are limited to 128 characters.

Usage

Example Request

Tag your Journeys