Skip to main content

Connecting Discord

Discord server setupConnect the creator server, then map PayBru tiers to Discord roles.

PayBru uses a member's linked Discord account, your connected Discord server, the PayBru bot, and mapped roles to keep server access in line with membership status.

ConnectedNot linkedNot in serverPermission error

Journey in This Video​

  • What the video shows: connect the creator Discord server, check tier role status, and link the member Discord account under Connected Accounts.
  • Who it is for: creators setting up Discord role access and members troubleshooting missing roles.
  • Where to start: creators open Settings > Integrations in the Manage Portal; members open Resources > My Profile > Security > Connected Accounts.
  • What to do next: invite the PayBru bot, keep the bot role above mapped roles, map tiers, and make sure the member joins the creator server.
  • Important distinction: creator Discord server setup is separate from a member linking their personal Discord account.
Discord access journey: connect the creator server, check tier role status, then link the member's Discord account under Connected Accounts.

The Four Moving Parts​

MemberDiscord account

The member links Discord from their PayBru profile so PayBru knows which Discord account should receive a role.

CreatorDiscord server

The creator connects the community's server from Settings > Integrations in the Manage Portal.

AutomationPayBru bot

The bot sits in the server and adds or removes mapped roles when membership access changes.

AccessMapped role

A Discord role is mapped to a PayBru tier. Channel permissions in Discord decide what that role can see.

Before You Start​

You need:

  • A PayBru community.
  • Server owner or admin access in the Discord server you want to connect.
  • The ability to approve a Discord bot authorization prompt.
  • At least one membership tier in PayBru if you want role-based access. See Setting Up Memberships.
Discord permission model

Discord separates user authorization from bot permissions. The member authorizes a linked account; the server admin authorizes the PayBru bot for the server. Discord's developer docs describe this as OAuth2 scopes plus server permissions.

Connect the Server​

Open the Manage Portal

Sign in to PayBru, go to My Activity > My Communities, then select Manage on the community.

Open Discord integration settings

Go to Settings > Integrations and open the Discord connection area.

Link your Discord account if prompted

This lets PayBru show the Discord servers you can manage. Linking your account is different from connecting a creator server.

Invite the PayBru bot

Choose Invite PayBru Bot, select the server, and approve the Discord authorization prompt.

Refresh and select the server

Return to PayBru, refresh the server list if needed, then choose the server where the PayBru bot is active.

Confirm the connection

The server should show as connected before you map roles in the tier wizard.

PayBru Settings Integrations page showing Discord connection controls
The Integrations tab is where creators connect Discord before mapping roles

Bot Permission Callout​

Required for rolesManage Roles

Lets the PayBru bot add and remove mapped roles. Discord still blocks roles above the bot's highest role.

Required for checksView Channels and Read Message History

Helps PayBru confirm members are in the server and keep the bot visible to the areas it needs.

Optional moduleBan Members

Needed only when you use Discord ban syncing or moderation-related Discord features.

Setup promptAdministrator

If Discord shows an Administrator prompt during setup, it grants the bot all server permissions. Keep the bot role below human Owner/Admin/Mod roles.

PayBru does not need to read member DMs, and it does not DM members on its own.

Get the Role Hierarchy Right​

Discord enforces a strict rule: a bot can only manage roles below its own highest role. If the PayBru bot role is below a paid tier role, PayBru cannot grant or revoke that role even when the member's PayBru membership is active.

Top of Discord role list

Ownerhuman only
Adminhuman only
Moderatorhuman only
PayBru botmust sit above mapped roles
VIPPayBru assigns
SupporterPayBru assigns
FollowerPayBru assigns
@everyonebase server access

To set this up:

  1. In Discord, open Server Settings > Roles.
  2. Find the PayBru bot role.
  3. Drag it above every role you want PayBru to assign.
  4. Keep it below roles you do not want PayBru to manage, such as Owner, Admin, or Mod roles.

For Discord's own technical reference, see OAuth2 and Permissions and Server and Channel Management.

Map a Tier to a Discord Role​

  1. In the Manage Portal, go to Tiers.
  2. Create or edit a tier.
  3. Open the Discord step in the tier wizard.
  4. Select the mapped role for each connected Discord server that should grant access.
  5. Save the tier.

After that, PayBru updates roles automatically when a member joins, renews, upgrades, downgrades, has a payment fail beyond grace, or cancels. See Automating Access by Membership Status for the full status-to-role behavior.

Member Side of the Connection​

Step 1Connect Discord account

The member links Discord under Resources > My Profile > Security > Connected Accounts.

Step 2Join the creator server

The same Discord account must be in the creator's server before a mapped role can apply.

If the member is in the server but has not linked Discord, PayBru cannot match the PayBru member to the Discord account. If the member has linked Discord but has not joined the creator's server, PayBru waits until they join.

If It Does Not Work​

Check these states in order:

ConnectedNot linkedNot in serverPermission errorMissing role
  • Confirm the member's PayBru membership is Active.
  • Confirm the member has linked Discord to their PayBru profile.
  • Confirm the member is actually in the Discord server, not just invited.
  • Confirm the tier has a mapped role for that server.
  • Confirm the PayBru bot role is above every role it needs to assign.
  • In Settings > Integrations, use Refresh or reconnect Discord if the connection looks stale.

See Common Discord Sync Issues for deeper troubleshooting.

See Also​