> For the complete documentation index, see [llms.txt](https://docs.xaman.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xaman.dev/concepts/limitations/push-permission.md).

# Push permission

Two types of Push:

1. Payload (Sign Request Push). **Any application can send Sign Requests with a push notification after the user interacted with the app at least once**.

   1. Backend integration: the Webhook & Payload **get** will contain a **user token** after the user decided to interact by signing a payload.
   2. xApp & Browser (Web3) integrations obtain a user token after xApp open / Sign In.\\

   \- A **user token** is valid for 30 days (default, can be extended on a per app basis if good reasons are provided). Every time the user interacts with the app again, the 30 day cycle will reset.\
   \- When creating a new payload (sign request), the user token can be specified in the payload, after which the user will receive a push notification, and the sign request will present itself in the Event List of the user.\
   \- Users can revoke the user token validity in Xumm (Settings - 3rd party apps - Revoke)\
   \- A **user token** is user & app bound, meaning the same user token can only be used by the API credentials it was originally extended to.
2. Custom xApp push events. **Custom xApp push events are permissioned.**
   1. Notification with link to xApp
   2. Notification with link to xApp & Event in Event list with link to xApp


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.xaman.dev/concepts/limitations/push-permission.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
