project.* events
Project lifecycle, resource link / unlink, payment method changes.
Project lifecycle, resource link / unlink, payment method changes. Fires whenever a project is created, updated, archived, restored, or deleted, plus transitions on its resources and payment methods. A project's connectors have their own family, connector.*.
Background
Example payload
{
"id": "evt_01HX...",
"type": "project.created",
"created_at": "2026-05-18T10:05:00Z",
"api_version": "2026-05-01",
"project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
"data": {
"project": {
"id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
"name": "Research Premium",
"handle": "research-premium",
"active": true,
"team_id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86"
}
}
}Required abilities
This family is the one exception to "one ability per family": the resource and payment-method events are scoped separately from the project itself.
| Events | Ability |
|---|---|
project.created, project.updated, project.archived, project.restored, project.deleted | project:view |
project.resource.created, project.resource.linked, project.resource.unlinked, project.resource.updated, project.resource.deleted, project.resource.status_changed | project-resource:view |
project.payment_method.updated, project.payment_method.deleted | project-payment-method:view |
Events
project.createdA creator registers a new project.project.updatedAny mutable project field changes.project.archivedCreator archives the project; access is suspended.project.restoredAn archived project is re-activated.project.deletedProject hard-deleted. Final event from that project.project.resource.createdA manual perk is registered under a project.project.resource.linkedA place a creator picked on a connector becomes a resource of a project.project.resource.unlinkedResource disconnected from a project.project.resource.deletedResource soft-deleted from a project.project.resource.updatedA resource's title, description or on/off switch changes, or a recovery moves it onto another place.project.resource.status_changedA channel or group enters or exits a degraded state: banned, deleted, or the bot lost its rights.project.payment_method.updatedA payment gateway's credentials, link state or on/off switch changes.project.payment_method.deletedA payment gateway is removed from a project.How is this guide?
Last updated on