🏷️Tags

Tags are where you'll have the ability to tag customers with a certain condition, for example, "Golf Member" then within Stampede, you'll be able to create a segment that searches for customers with this tag/multiple tags.

Fetch the current tags of a guest

GET /v1/guests/:guest_id/tags

Query Parameters

Name	Type	Description
guest_id	String

200: OK

Add a new/existing tag to a guest

PUT /v1/guests/:guest_id/tags

Request Body

Name	Type	Description
name*	String

200: OK

400: Bad Request

Delete a tag by name from a guest (Idempotent)

DELETE /v1/guests/:guest_id/tags/by-name

Remove a tag from a customer profile by name. This endpoint is idempotent - it's safe to call multiple times. Returns 200 OK whether the tag was found or not, as long as the customer exists.

Request Body

Name	Type	Description
tag_name*	String	Name of the tag to remove (1-255 characters)

200: OK Tag deleted or not found

{
  "message": "Tag removed from customer profile"
}

or

{
  "message": "Tag not found on customer profile"
}

404: Not Found Customer doesn