Skip to main content

App uninstalled

Webhook

Fires when your app's installation is removed from a Roam — for example an admin revokes the installed app, or the developer archives the API client. Roam enqueues this delivery before tearing down your webhook subscriptions and tokens, so you get a last-gasp signed callback.

Event name: app.uninstalled

Delivered inside the standard event envelope; the schema below shows the full delivery body with this event's payload under data.

Delivery is authenticated by your webhook signing secret. After this event, discard all tokens for the install and stop retrying API calls.

Calling token.revoke does not fire app.uninstalled — that endpoint only kills the presented grant and fires token.revoked.

Required scope: webhook:write (the same scope needed to subscribe).

Request​

Responses​

Return a 200 status to acknowledge receipt of the event