Guide

Add Connector - Slack

Overview

Airbyte is a data integration platform that enables AI agents to read from and write to your business applications in real-time. Adding a Slack connector allows your Airbyte-powered agents to interact with Slack—sending messages, updating channels, and performing other write operations. This authentication workflow establishes a secure, permission-scoped connection between Airbyte and your Slack workspace, ensuring your agent has the correct access level while maintaining security best practices.

Before you begin

  • An active Airbyte account with admin or developer access (you must be logged in to app.airbyte.ai)
  • A Slack workspace admin or app manager account with permission to authorize third-party applications
  • Access to your Slack workspace's OAuth authorization screen (you will be redirected to Slack during this process)
  • Clarity on which Slack workspace you want to connect if you manage multiple workspaces

Step by step

1
ClickCredentials

Navigate to the Credentials section of Airbyte by clicking the 'Credentials' link in the main navigation. This is where you manage all authenticated data source and destination connections.

Step 1
2
ClickAdd Credential

Click the 'Add Credential' button to begin adding a new connector. This opens a list of available data sources and destinations you can authenticate with Airbyte.

Step 2
3
ClickSlack

Select 'Slack' from the list of available connectors. This tells Airbyte that you want to add a Slack workspace as a credential.

Step 3
4
ClickAuthenticate your Slack account

Click the 'Authenticate your Slack account' button to start the OAuth authorization flow. This will redirect you to Slack's authorization screen where you grant Airbyte permission to access your workspace.

Step 4
5
Switch Tab

Your browser will automatically switch to a new tab or window that opens the Slack authorization page. This is part of the standard OAuth flow and happens automatically.

Tip. If a new window did not open, check your browser's pop-up blocker settings and ensure app.airbyte.ai is allowed to open pop-ups.
6
Navigate

You will be taken to slack.com, the Slack login and authorization portal. If you are not already logged in, enter your Slack credentials here.

7
Navigate

You will be redirected to your Slack workspace domain (e.g., browzerlabs.slack.com). This confirms you are authorizing the correct workspace.

Tip. Verify that the workspace name in the URL matches the workspace you intend to connect. If you manage multiple workspaces, confirm this is the correct one.
8
ClickSelect a team

If you manage multiple Slack workspaces, click the 'Select a team' dropdown to choose the workspace you want to connect to Airbyte. Select the appropriate workspace from the list.

Step 8
9
ClickBrowzer

From the dropdown menu, click on the workspace name (e.g., 'Browzer') that you want to authorize. This confirms your selection and prepares the authorization page for that specific workspace.

Step 9
10
Navigate

You will be navigated to the authorization page for your selected workspace (e.g., browzerlabs.slack.com). This is where you will review and approve Airbyte's requested permissions.

11
ClickAllow

Click the 'Allow' button to grant Airbyte permission to access and interact with your Slack workspace. This authorizes the OAuth token that Airbyte will use for all future Slack operations.

Tip. Review the permissions Slack displays before clicking Allow. Ensure that message write access and any other requested scopes align with your security policies.
Warning. Once you click 'Allow', Airbyte will have the permissions listed on the authorization screen. Ensure you trust Airbyte to write messages and perform other actions in your Slack workspace.
Step 11
12
Navigate

After authorization, your browser will automatically return to app.airbyte.ai with your OAuth token securely saved. You should now see the credentials configuration screen.

13
Clickgeneric

Click in the main content area of the credentials configuration form to ensure it is active and ready for input. This prepares the form for the next step.

Step 13
14
ClickWrite access for Messages

Enable the 'Write access for Messages' checkbox to grant your Airbyte agents the ability to send and modify messages in Slack. This permission is required if you plan to use Slack as a destination for agent-generated content.

Tip. If you only need to read from Slack (not send messages), you can leave this unchecked. However, for most AI agent workflows, message write access is essential.
Warning. Enabling write access means your agents can send messages to any channel or user that the authorized Slack app has permission to access. Ensure this aligns with your security and governance policies.
Step 14
15
ClickSave

Click the 'Save' button to finalize and store your Slack credential in Airbyte. This completes the authentication process and makes Slack available as a destination for your agent workflows.

Tip. After saving, you can test the connection by creating a new Airbyte connection or agent that uses this Slack credential.
Step 15

Confirm it worked

  1. 1After saving, you should see the Slack credential listed in the Credentials section of Airbyte with a status of 'Connected' or 'Active'
  2. 2The credential card should display 'Write access for Messages' as enabled (checkbox checked)
  3. 3When creating a new Airbyte connection or agent, the Slack connector should appear as an available destination option
  4. 4No error messages or permission warnings appear on the credentials page

Common issues

Keep reading