Slack (Configuration Token)

Quickstart

Connect to the Slack App Manifest APIs with Nango in 2 minutes.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Slack (Configuration Token).

Authorize Slack (Configuration Token)

Go to Connections -> Add Test Connection -> Authorize, then enter your app configuration refresh token (how to generate one). Later, you’ll let your users do the same directly from your app.

Call the Slack App Manifest API

Let’s make your first request to the Slack App Manifest API. Replace the placeholders below with your Environment API key, integration ID, and connection ID:

cURL
Node

curl -X POST "https://api.nango.dev/proxy/apps.manifest.create" \
  -H "Authorization: Bearer <NANGO-API-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>" \
  -H "Content-Type: application/json" \
  -d '{"manifest": "{\"display_information\":{\"name\":\"My generated app\"}}"}'

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ apiKey: '<NANGO-API-KEY>' });

const res = await nango.post({
    endpoint: '/apps.manifest.create',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>',
    data: {
        manifest: JSON.stringify({ display_information: { name: 'My generated app' } })
    }
});

console.log(res.data);

Or fetch credentials with the Node SDK or API.You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.

API gotchas

Config tokens are scoped to one Slack user and workspace, not to an app. Any app created through this connection is homed in the workspace the user selected when generating the token, and the connection can configure any app that user owns in that workspace.

Config tokens cannot call workspace APIs. For regular Slack workspace access (sending messages, reading channels), use the standard Slack integration. Workspace bot tokens cannot call the Manifest APIs.

Do not rotate the refresh token manually. Slack invalidates each refresh token every time it is exchanged. After you submit it to Nango, do not reuse it in another tool or call tooling.tokens.rotate yourself, or the connection will break.

Overview

1,000+ APIs & Integrations

Slack (Configuration Token)

Overview

Quickstart