{% event %}

Attributes

Parameter	Type	Required	Description
name	string	✓	Kebab-case event name (e.g., 'user-logged-in')

Valid Children

Tag	Multiplicity
{% property %}	[*]

Valid Parent Contexts

This tag is valid inside: {% api %}

Rules

Rule	Force	Realm	Reference	Description
event-names-kebab-case	must	global	—	Event names use plain kebab-case — no type prefix. conventionnaming
event-names-past-tense	should	global	—	Event names should be in past tense to indicate completion (e.g. , ). conventionnaming

Events are system-emitted notifications. They model the observable side-effects of actions and are referenced from flow paths via emit= to declare what happens when a branch succeeds.

Event definition with payload properties

tageventpropertyapi event-tag-payload

{% event name="bookmark-added" %}
Emitted after a bookmark is successfully created.

{% property name="bookmarkId" type="uuid" required=true /%}
{% property name="url" type="string" required=true /%}
{% /event %}