Skip to main content
Tags help you organize Push Notification and Live Activity history around the people, customers, environments, or workflows that matter to you. For example:
  • user:382
  • billing
  • environment:production
  • order_9381

Add Tags

Add an optional top-level tags array when sending a Push Notification or starting a Live Activity. New tags are created automatically when you first use them.

Push Notifications

Live Activities

Filter History

Use one or more tags to filter Push Notification and Live Activity history.
  • Click a tag in Push Notification history to see Push Notifications with that tag.
  • Click a tag in Live Activity history to see Live Activities with that tag.
  • Open Tags in the ActivitySmith web app and click a tag to see its combined Push Notification and Live Activity history.
  • When filtering by multiple tags, choose whether results must match all tags or any tag.

Manage Tags

The Tags page in the ActivitySmith web app shows every tag and its usage across Push Notifications and Live Activities. From there, you can:
  • Search and sort tags.
  • Rename a tag. The new name appears throughout notification history.
  • Delete individual tags or select multiple tags for deletion.
  • Delete all tags.
Deleting a tag removes it from associated history records. It does not delete the Push Notifications or Live Activities themselves.

Tag Format

  • Up to 20 unique tags per request.
  • Between 1 and 64 characters per tag.
  • Supported characters: lowercase letters, numbers, dashes (-), underscores (_), periods (.), and colons (:).
  • Tags are trimmed, converted to lowercase, and deduplicated.
See the endpoint documentation for complete request fields: