Skip to main content
Your dedicated Ryvn hub sends notifications through a Slack app that your organization owns. You create the app in Slack, send the client credentials to Ryvn, then connect it from your hub and choose a channel for notifications.
You need permission to create and install apps in your Slack workspace and the hub domain Ryvn gave you (for example acme.ryvn-abc12.ryvn.run). If your workspace requires app approval, ask a workspace owner or app manager to approve the app. You also need permission to manage integrations in your Ryvn organization to connect it.
1

Create the app

Open Your Apps, click Create New App, and choose From scratch.Click Create App.
2

Enable incoming webhooks

Open Incoming Webhooks and turn Activate Incoming Webhooks on.Ryvn uses an incoming webhook to deliver notifications to the channel you select during connection. The hub saves that webhook automatically when you connect Slack in a later step.
3

Configure OAuth and permissions

Open OAuth & Permissions. Under Redirect URLs, click Add New Redirect URL, enter the following URL, replacing <hub> with your hub domain, and click Save URLs:
For example, a hub at acme.ryvn-abc12.ryvn.run uses https://api.acme.ryvn-abc12.ryvn.run/v1/integrations/slack/oauth/callback.
Check the hub domain before you save. It decides where Slack sends the authorization code. Only use the domain Ryvn gave you directly, never one from an unsolicited link.
Under Scopes → Bot Token Scopes, configure these four scopes. Enabling incoming webhooks adds incoming-webhook automatically; add the other three with Add an OAuth Scope.These are the scopes the hub requests during installation. Leave User Token Scopes empty, and leave token rotation and PKCE disabled. Socket Mode, Event Subscriptions, Interactivity and Slash Commands are not needed for notifications.
An app created for this workspace can stay undistributed. If it must be installed in another workspace, follow Slack’s distribution setup under Manage Distribution before connecting it there.
4

Hand the credentials to Ryvn

Open Basic Information → App Credentials. Send the following to your Ryvn contact over the agreed secure channel, never in plain-text email or chat:Ryvn configures your hub with these credentials, enables the Slack integration, and tells you when it is ready. The signing secret, verification token and bot token are not required for this handoff.
5

Connect Slack from your hub

Sign in at https://<hub>, select the Ryvn organization that should receive notifications, and open Settings → Notifications. Click Connect Slack.On Slack’s authorization screen, confirm the workspace, select the notification channel, and click Allow. To select a private channel, you must already be a member of it. Slack’s incoming webhook guide describes the channel selection flow.Wait for Slack connected successfully, then return to your hub’s Notifications page.
Start the connection from the hub. Installing from Slack’s Install App page or using Add New Webhook does not save a notification destination in your Ryvn organization. If you already installed the app that way, return to the hub and click Connect Slack to complete the connection.
6

Test delivery and choose notifications

On Settings → Notifications, click Test on the Slack destination. Confirm that This is a test notification from Ryvn arrives in the selected channel.Under Subscriptions, enable the notification types you want to receive. The hub currently supports one Slack destination per Ryvn organization. Contact Ryvn if you need to replace an existing connection or change its channel.

​
Troubleshooting

​
Updating the app later

When a Ryvn release needs additional permissions, Ryvn tells you what to change and how to reauthorize the connection. Coordinate client-secret rotation with your Ryvn contact so the hub uses the new secret before you reconnect Slack.