Appearance
Event types
Every significant action in your organization emits one of 43 event types. These events drive both workflows (automations inside the platform) and webhooks (deliveries to your own systems), so the same catalog applies to both.
Assignments
| Event | Fires when | Typical automation use |
|---|---|---|
assignment.created | A new assignment is created. | Notify the team that new work is available. |
assignment.updated | Assignment details (name, reference, fields) change. | Sync changes to your claim system. |
assignment.status_changed | An assignment moves to a new status. | Email the claims inbox on every status move. |
assignment.archived | An assignment is archived. | Close out the record in external systems. |
Users
| Event | Fires when | Typical automation use |
|---|---|---|
user.created | A user is added to the org. | Send a welcome message or provision accounts elsewhere. |
user.updated | A user's name or role changes. | Keep an HR directory in sync. |
user.deactivated | A user is deactivated. | Revoke access in connected systems. |
user.deleted | A user is deleted. | Final cleanup in connected systems. |
Invitations
| Event | Fires when | Typical automation use |
|---|---|---|
invitation.sent | An assignment-level invitation is sent. | Log outreach to contractors. |
invitation.accepted | An invitee accepts access. | Notify the assignment owner the person they shared it with is in. |
invitation.revoked | An invitation or grant is revoked. | Confirm access removal for compliance records. |
Access
| Event | Fires when | Typical automation use |
|---|---|---|
access.granted | A person is granted access to an assignment. | Audit trail forwarding to a security system. |
access.revoked | Access is removed. | Confirm offboarding of a contractor. |
Locations (rooms)
| Event | Fires when | Typical automation use |
|---|---|---|
location.created | A room is added to an assignment. | Track scope growth on a loss. |
location.updated | A room's name, order, assignee, or notes change. | Keep external room lists current. |
location.deleted | A room is soft-deleted. | Flag scope changes for review. |
location.claimed | A field user claims a room to work it. | See rooms being picked up in real time. |
location.unclaimed | A claimed room is released. | Spot rooms going back to the pool. |
location.completed | A room is marked complete. | Track per-room progress toward assignment completion. |
Groups
| Event | Fires when | Typical automation use |
|---|---|---|
group.created | A media group is created. | Mirror organizational structure externally. |
group.updated | A group changes. When a group is switched between items and scoping, data.fields is ["intent"] and data.intent is the new value. | Keep external groupings in sync. |
group.deleted | A group is removed. | Clean up mirrored structures. |
People
| Event | Fires when | Typical automation use |
|---|---|---|
person.created | A person record is added. | Populate a contacts database. |
person.updated | A person record changes. | Keep contact details in sync. |
Media
| Event | Fires when | Typical automation use |
|---|---|---|
media.captured | A photo, video, or audio clip is captured on a device. | Real-time capture notifications. |
media.uploaded | One file of a media item (the full size original, the preview copy, or the thumbnail) finishes uploading. Fires once per file. | Backups of individual files. |
media.synced | A photo or video has fully synced: both the original and the preview copy are safely stored. Fires exactly once per item. | Send new media to ContentsVision, or any outside processing. |
media.upload_failed | An upload fails. | Alert team admins to connectivity problems. |
media.updated | A media item changed. From the console: a note is added or edited (console tag changes fire tag.applied / tag.removed instead). From the field app: the photo is moved to another room or group, its tags or note change, or it is marked or unmarked as a scoping shot (intent) or its item marks change (marks). Also fires when a new original file replaces an already synced one, and once for each photo in a group that is switched between items and scoping (data.via is group). data.fields lists what changed. | Keep an outside copy of the media in step. |
media.deleted | A media item is deleted, from the console or the field app. | Record deletions for compliance, or remove the item downstream. |
Every media event carries the assignment, room, and group the item belongs to (data.assignmentId, data.locationId, data.groupId) and its type (data.type: photo, video, or audio), so a workflow always knows which job the media is part of.
Submissions
| Event | Fires when | Typical automation use |
|---|---|---|
submission.created | A locked hand-off is submitted from the field. | SMS the team's admins that work has landed. |
Tags
Applying a tag fires the event on the thing that was tagged, with data.tags listing the exact tag names that changed and data.assignmentId carrying the job, so a workflow can trigger on one tag in particular. See Tags in workflows.
| Event | Fires when | Typical automation use |
|---|---|---|
tag.applied | A tag is put on an assignment, room, or media item. | Escalate the moment somebody marks a job urgent. |
tag.removed | A tag is taken off one. | Clear a downstream flag when review finishes. |
tag.created | A new tag is defined for the organization. | Mirror the vocabulary into another system. |
tag.updated | A tag is renamed or recoloured. | Keep an external mapping in step with a rename. |
tag.deleted | A tag is deleted from the organization. | Warn when a tag an integration depends on disappears. |
Workflow-applied tags do not retrigger workflows
A tag applied by a workflow is recorded as a system action, and system actions never start another workflow. A flow that tags on tag.applied cannot spin.
Profiles
| Event | Fires when | Typical automation use |
|---|---|---|
profile.created | A new capture profile draft is created. | Track profile authoring activity. |
profile.published | A profile is published and becomes usable. | Notify admins a new form is live. |
profile.archived | A profile is retired. | Stop using the profile in external intake tools. |
Webhooks and integrations
| Event | Fires when | Typical automation use |
|---|---|---|
webhook.endpoint.created | A webhook endpoint is added. | Security monitoring of integration changes. |
webhook.delivery.failed | A webhook delivery fails. | Page the integrations owner when deliveries break. |
integration.token.created | An integration token is issued. | Log credential issuance for audit. |
integration.token.revoked | An integration token is revoked. | Confirm credential retirement. |
Same events, two consumers
Everything in this catalog can trigger a workflow in the console and can be delivered to a webhook endpoint. Use workflows for messages and status changes; use webhooks when your own systems need the raw event.