Skip to content
Docs

Give a hire a Slack identity

POST
/api/workspaces/{ws}/slack/{connection}/hires/{hire}

Makes the hire's own Slack app from a manifest. Slack allows about one a minute.

Authorization

session
cookiebetter-auth.session_token<token>

Set by POST /api/auth/sign-in/email.

Path Parameters

ws*string

The workspace id (from GET /api/me).

connection*string

The connection's id (from GET /api/workspaces/:ws/connections).

hire*string

The hire's id.

Response Body

The app, and how to install it.

Example Request
curl -X POST 'https://app.useroster.work/api/workspaces/string/slack/string/hires/string'
Example Response
Empty

A tool's webhook POST

Called by the tool, not by you: WhatsApp, Chatwoot and Twilio send customers' messages here (and Stripe its events), each signed with a secret of the connection's (WhatsApp's X-Hub-Signature-256, Chatwoot's X-Chatwoot-Signature, Twilio's X-Twilio-Signature over this address and the form fields). Unsigned or wrongly signed deliveries are refused; each message is kept once, however often it's sent. Hires read them and are woken by them.

Take a hire out of Slack DELETE

Deletes the hire's Slack app.