curl "https://app.runtm.com/api/v1/slack/oauth/install-url" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
resp = requests.get(
"https://app.runtm.com/api/v1/slack/oauth/install-url",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
)
data = resp.json()
print(f"Redirect user to: {data['url']}")
const resp = await fetch(
"https://app.runtm.com/api/v1/slack/oauth/install-url",
{
headers: {
Authorization: "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await resp.json();
{
"url": "https://slack.com/oauth/v2/authorize?client_id=xxx&scope=app_mentions:read,chat:write,channels:read,...&redirect_uri=...&state=..."
}
Slack
OAuth Install URL
Get the Slack OAuth URL to install the managed Runtime app.
GET
/
api
/
v1
/
slack
/
oauth
/
install-url
curl "https://app.runtm.com/api/v1/slack/oauth/install-url" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
resp = requests.get(
"https://app.runtm.com/api/v1/slack/oauth/install-url",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
)
data = resp.json()
print(f"Redirect user to: {data['url']}")
const resp = await fetch(
"https://app.runtm.com/api/v1/slack/oauth/install-url",
{
headers: {
Authorization: "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await resp.json();
{
"url": "https://slack.com/oauth/v2/authorize?client_id=xxx&scope=app_mentions:read,chat:write,channels:read,...&redirect_uri=...&state=..."
}
Returns the Slack OAuth authorization URL for the managed Runtime app. After the user authorizes on Slack, they are redirected back to complete the integration setup.
Requires
SLACK_CLIENT_ID to be configured.
Required scope: integrations:write
Requires organization context via the
X-Organization-Id header.string
required
The organization to install the integration for.
string
Optional. Dev server URL for OAuth proxy redirect during local development.
string
required
Slack OAuth authorization URL. Redirect the user here.
curl "https://app.runtm.com/api/v1/slack/oauth/install-url" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
resp = requests.get(
"https://app.runtm.com/api/v1/slack/oauth/install-url",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
)
data = resp.json()
print(f"Redirect user to: {data['url']}")
const resp = await fetch(
"https://app.runtm.com/api/v1/slack/oauth/install-url",
{
headers: {
Authorization: "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await resp.json();
{
"url": "https://slack.com/oauth/v2/authorize?client_id=xxx&scope=app_mentions:read,chat:write,channels:read,...&redirect_uri=...&state=..."
}