Skip to main content
On a self-hosted PostQueen the VK ID app is yours. You create a Web app in the VK ID business account, add PostQueen’s trusted redirect URL, and give PostQueen the app ID. VK ID signs in with PKCE, so there is no secret to set. Posting to a wall also needs an access right that VK grants only on request.

​
Before you start

PostQueen does not check the granted scopes when a channel connects.

​
Create the app

1

Add the application

In the VK ID business account, open Мои приложения (My apps) and choose Добавить приложение (Add application). Enter a name, choose the Web platform and pick an image.
2

Set the base domain and trusted redirect URL

Fill in Базовый домен (base domain) and Доверенный redirect URL (trusted redirect URL). The redirect URL’s domain must match the base domain exactly.VK does not send people back to a plain http address, so when your FRONTEND_URL is not https, PostQueen sends VK a callback wrapped in redirectmeto.com, and that wrapped address is the one to register:Choose Создать приложение (Create application).
3

Turn on email

Under Доступы (Access), switch on Почта (email) and save. PostQueen asks for the email scope.
4

Copy the app ID

Open the app card, then Информация о приложении (App information), and copy ID приложения (App ID). That is the only value PostQueen needs.

​
Set the variable

Add the app ID to your environment:
PostQueen sends it on the sign-in, on the token exchange and on every wall call, so it stays in use for the life of the channel. Recreate the app container so it reads the new variables. A plain docker restart or docker compose restart keeps the old container and its old environment. In the folder that holds docker-compose.yaml, recreate only the postqueen service:
The database, Redis and Temporal keep running. Avoid docker compose down for a settings change: on a host that runs other Compose services in the same project, it stops them too. Then open PostQueen, go to Channels, choose Add Channel and pick this network. You are sent to its login to authorize PostQueen, and the channel appears in the Channels list once you accept.
The channel is in the Channels list with its avatar and name.
Add Channel does not check whether your variables are set. A missing or misspelled key shows up as a broken authorization page on the network’s side rather than a helpful message in PostQueen, so if the login page itself looks wrong, check the keys before anything else.
Pick VK, sign in with VK ID and approve access. Posts go to that account’s own wall.

​
App review

  • Extended rights. VK ID grants vkid.personal_info, email and phone to any app. The others PostQueen asks for, wall, photos, video, docs and status, are extended rights that VK grants only in exceptional cases. Request them by email to devsupport@corp.vk.com, saying what your app posts and why. Until VK grants them, the sign-in can stop with invalid_scope.
  • Business verification. VK asks accounts created after December 15, 2025 to verify their business profile within 60 days of their first app, or the apps are blocked.
  • The code exchange. PostQueen sends no secret or service key when it exchanges the sign-in code. If VK refuses the exchange, check the confidentiality level under Ключи доступа (Access keys): a confidential app expects a service key.

​
Troubleshooting

The app does not have every right PostQueen asks for. Request the extended rights as described in App review, then connect again.
The trusted redirect URL is not exactly the one PostQueen sent. With a plain http FRONTEND_URL, register the redirectmeto.com address from step 2, not the bare localhost one.
VK reports some errors inside a normal-looking answer, and PostQueen does not read them, so a post made without the wall right can show as published. Check that VK granted the app the wall right.
Last modified on September 23, 2026