Event Types
Complete reference of all webhook event types available in YAPL.
Webhook Event Types
YAPL can send webhook notifications for events across projects, teams, plans, and workspaces. This page lists every available event type with a description of when it fires.
Event Type Format
Event types follow the pattern domain.action.version:
project.created.v1
│ │ │
│ │ └── Version (for future compatibility)
│ └────────── What happened
└────────────────── Which areaProject Events
Triggered when projects are created, updated, archived, restored or deleted.
| Event Type | Description |
|---|---|
project.created.v1 | A new project was created |
project.updated.v1 | A project's details were changed (name, description, dates, budget) |
project.deleted.v1 | A project was permanently deleted |
project.archived.v1 | A project was moved to the archive |
project.restored.v1 | An archived project was restored to active status |
Team Events
Triggered when teams or team membership changes.
| Event Type | Description |
|---|---|
team.created.v1 | A new team was created |
team.updated.v1 | A team's details were changed (name, description) |
team.deleted.v1 | A team was deleted |
team.member-added.v1 | A member was added to a team |
team.member-removed.v1 | A member was removed from a team |
team.member-role-changed.v1 | A team member's role was changed (e.g., Member to Lead) |
Plan Events
Triggered when plans (scheduling documents within projects) are modified.
| Event Type | Description |
|---|---|
plan.created.v1 | A new plan was created |
plan.published.v1 | A plan was published (made visible to the team) |
plan.archived.v1 | A plan was archived |
plan.restored.v1 | An archived plan was restored |
plan.deleted.v1 | A plan was permanently deleted |
Task Events
Triggered when a task inside a published plan changes. Publishing a plan sends one plan.published.v1 that lists every change; the per-task events of that publish are not sent separately.
| Event Type | Description |
|---|---|
plan.task.updated.v1 | A task's details were changed |
plan.task.status.changed.v1 | A task's status changed (e.g., Not Started to In Progress) |
plan.task.assigned.v1 | A person was assigned to a task |
plan.task.unassigned.v1 | A person was removed from a task |
Workspace Events
Triggered when workspace ownership changes.
| Event Type | Description |
|---|---|
workspace.owner-added.v1 | Someone accepted an invitation to become a workspace owner. The payload includes their e-mail address. |
Event Payload Examples
Project Created
{
"id": "evt_abc123",
"type": "project.created.v1",
"timestamp": "2026-03-25T10:30:00.000Z",
"workspaceId": "ws_xyz789",
"data": {
"projectId": "proj_456",
"projectName": "Office Renovation",
"status": "planning",
"teamId": "team_321",
"teamName": "Operations",
"actorName": "John Smith"
}
}Team Member Added
{
"id": "evt_def456",
"type": "team.member-added.v1",
"timestamp": "2026-03-25T11:00:00.000Z",
"workspaceId": "ws_xyz789",
"data": {
"teamId": "team_321",
"teamName": "Engineering",
"memberId": "user_890",
"memberName": "Jane Doe",
"role": "member",
"actorName": "John Smith"
}
}Task Updated
{
"id": "evt_ghi789",
"type": "plan.task.updated.v1",
"timestamp": "2026-03-25T14:15:00.000Z",
"workspaceId": "ws_xyz789",
"data": {
"planId": "plan_555",
"planName": "Q2 Schedule",
"taskId": "task_777",
"taskName": "Foundation Work",
"actorName": "Jane Doe"
}
}Filtering Events
When creating or editing a webhook endpoint, choose which events it receives:
- All events (default) — The endpoint receives every event on this page, including event types added later
- Specific events — Turn off All events and tick the events your integration needs
For example, a Slack channel for project updates might subscribe only to project.created.v1, project.archived.v1 and plan.published.v1.
Data Sensitivity
YAPL automatically strips sensitive fields from webhook payloads before delivery. The following fields are never included:
- Passwords and password hashes
- Access tokens and refresh tokens
- API keys and secrets
- Session identifiers
- IP addresses and user agents
Names and user IDs are included. workspace.owner-added.v1 also carries the new owner's e-mail address.
Related Topics
- Creating Webhooks — Set up endpoints
- Delivery Logs — Monitor delivery status
- Verifying Signatures — Secure your endpoint
Was this page helpful?