Slack

​

What’s Supported

​

Supported Actions

• Read Actions, including full historic backfill and incremental read.
• Write Actions.
• Proxy Actions, using the base URL https://slack.com/api.

​

Before You Get Started

• Client ID
• Client Secret
• Scopes

​

Create a Slack Account

• Go to the Slack Sign Up page.
• Sign up using your preferred method and verify your email.

​

Creating a Slack App

1. Log in to your Slack Developer account.
2. Click Your Apps.
3. Click the Create New App button.
4. In the Create a Slack App pop-up window, enter the App Name and select the Development Slack Workspace where you want to develop your app. Click Create App.
5. In the left-hand sidebar, navigate to OAuth & Permissions.
6. In the Redirect URLs section, click Add a Redirect URL and enter the Ampersand redirect URL: https://api.withampersand.com/callbacks/v1/oauth.
7. Click Add and then Save URLs.
8. In the Scopes section, add the necessary OAuth scopes for your app by clicking on Add an OAuth Scope and selecting the required scopes. You will find the Client ID and Client Secret in the Basic Information section. Note these credentials, as you will need them to connect your app to Ampersand.

​

Add Your Slack App Info to Ampersand

1. Log in to your Ampersand Dashboard.
2. Select the project where you want to create a Slack integration.
3. Select Provider Apps.
4. Select Slack from the Provider list.
5. Enter the previously obtained Client ID in the Client ID field and the Client Secret in the Client Secret field.
6. Enter the scopes set for your application in Slack.
7. Click Save Changes.

​

Create a manifest file like the example.

​

Additional Information

• If your integration has Read Actions, you’ll start getting webhook messages.
• If your integration has Write Actions, you can start making API calls to our Write API.
• If your integration has Proxy Actions, you can start making Proxy API calls.