Skip to main content

conversations.acceptSharedInvite method

Welcome to the new home of Slack developer docs!

We're still building and not all features are available quite yet. Enjoy this peek into the future!

Not ready for the future? Return to the past at api.slack.com.

Usage info

This Slack Connect API method accepts an invitation to a Slack Connect channel.

If the channel does not already exist in your app's workspace, this method creates, and names, the Slack Connect channel inside your workspace.

If your app's workspace is not on a paid plan, this API will also start a free trial for your workspace (as long as you qualify and you use the free_trial_accepted parameter.

After an invite is accepted by your app, the Slack Connect channel may still need to be approved by Admins on your workspace or the host organization.

Response

When your app successfully accepts a Slack Connect channel invite:

{
"ok": true,
"implicit_approval": true,
"channel_id": "C0001111",
"invite_id": "I00043221"
}

If your app cannot accept because the workspace on which your app is installed has already had a free trial in the past and is not a paid team currently:

{
"ok": false,
"error": "not_paid"
}