POST/api/v1/slack/connect

Finish Add to Slack

The end of Add to Slack: code and state from Slack's redirect. Connects that Slack workspace to this Markdrop workspace (one Slack workspace per Markdrop workspace: 409 when it's connected elsewhere) and links your own Slack account. The state is for the account that started, and works once.

API token required20 per minute per IP

Guide: Slack

Code samples and Try it

Request body

application/json, required

codestringRequired
1–500 characters.
statestringRequired
1–1,000 characters.

Responses

200OK.
401No token, or the token is revoked or mistyped.
422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).
429Too many requests from your IP address. Wait the seconds in Retry-After.

bash

curl -X POST https://api.markdrop.in/api/v1/slack/connect \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"code":"CODE","state":"STATE"}'

javascript

const res = await fetch("https://api.markdrop.in/api/v1/slack/connect", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "code": "CODE",
    "state": "STATE"
  }),
});
const data = await res.json();

python

import os

import requests

r = requests.post(
    "https://api.markdrop.in/api/v1/slack/connect",
    headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"},
    json={"code": "CODE", "state": "STATE"},
)
r.raise_for_status()
print(r.json())

Try it

API token

Kept in this tab only, and sent only to the API. Create a token

coderequired

staterequired

Your request

curl -X POST https://api.markdrop.in/api/v1/slack/connect \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"code":"CODE","state":"STATE"}'

This calls the live API as you. Changes are real.

I understand, send real requests from this page

Tick the box above to send. Or copy the command and run it in a terminal.

Did this page help?