suggest_birthday()¶

Client.suggest_birthday()

Suggest a birthday date for another user.

Sends a birthday suggestion to a contact. The recipient can accept or ignore the suggestion from their own profile settings.

This method calls users.suggestBirthday (TL Layer 207+).

Usable by Users Bots

Parameters:

user_id (int | str) – Unique identifier or username of the target user.
day (int) – Suggested day of birth (1–31).
month (int) – Suggested month of birth (1–12).
year (int, optional) – Suggested year of birth. Omit to suggest only a day and month without a year.

Returns:

bool – True on success.

Raises:

RPCError – On Telegram API error.

Example

await app.suggest_birthday("username", day=1, month=1)

await app.suggest_birthday(123456789, day=15, month=6, year=1990)