tags

Triggered when tags are added to or updated on a call. Tags are labels you can attach to calls for categorization, filtering, and reporting.

When This Event Fires

• A user adds or removes tags on a call in the dashboard
• Tags are updated via the API
• An integration automatically applies tags to a call

Payload

Field	Type	Description
event	string	Always "tags"
caller	string	Caller phone number
receiver	string	Receiver phone number
time	string	Timestamp of the event
pbx_id	string	Unique call identifier in the PBX
tags	array of strings	Current list of tag names applied to the call

info

The tags field contains the full current list of tags on the call, not just the tags that were added or removed.

Example Payload

{
  "event": "tags",
  "caller": "+33612345678",
  "receiver": "+33198765432",
  "time": "2025-01-15T10:36:00Z",
  "pbx_id": "call_abc123",
  "tags": ["sales", "follow-up", "vip"]
}

Related Events

• incoming_call_end / outgoing_call_end — the call this tag event relates to