# KeyboardButtonRequestUsers

> This object defines the criteria used to request suitable users

**Category:** Telegram Bot API — Types (A-Z)  
**URL:** https://docs.botlify.cloud/keyboardbuttonrequestusers  
**Platform:** Botlify Cloud (https://botlify.cloud)  

---

This object defines the criteria used to request suitable users. Information about the selected users will be shared with the bot when the corresponding button is pressed. More about requesting users »

## Fields

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| request_id | Integer | Always | Signed 32-bit identifier of the request that will be received back in the UsersShared object. Must be unique within the message. |
| user_is_bot | Boolean | Optional | Pass True to request bots, pass False to request regular users. If not specified, no additional restrictions are applied. |
| user_is_premium | Boolean | Optional | Pass True to request premium users, pass False to request non-premium users. If not specified, no additional restrictions are applied. |
| max_quantity | Integer | Optional | The maximum number of users to be selected; 1-10. Defaults to 1. |
| request_name | Boolean | Optional | Pass True to request the users' first and last names |
| request_username | Boolean | Optional | Pass True to request the users' usernames |
| request_photo | Boolean | Optional | Pass True to request the users' photos |

> [!TIP]
> **Botlify Cloud Runtime**
> Credentials are auto-injected in .env — always load them with getenv(): BOT_TOKEN, ADMIN_CHAT_ID, BOT_USERNAME. Main database: database.db (SQLite, WAL mode). Runtime errors: error.log. Quick test: send to $ADMIN_CHAT_ID. Full details: Runtime Reference.