create_story_album()¶

Client.create_story_album()

Create a new story album for a user or channel.

Usable by Users Bots

Parameters:

chat_id (int | str) – Unique identifier or username of the peer who owns the album. Use "me" or "self" for your own profile.
title (str) – Title of the new album.
story_ids (List of int, optional) – IDs of stories to add to the album on creation. Pass an empty list or omit to create an empty album.

Returns:

StoryAlbum – The created story album.

Example

album = await app.create_story_album("me", "Summer 2024")
print(album.album_id, album.title)


album = await app.create_story_album("me", "Highlights", story_ids=[101, 102])