Contents

API reference / Actions

Propose routing a client's updates to the client's Slack or email

POST /api/v1/actions/client-routing

propose_client_routing Write MCP tool

For agencies: for one client brand, a weekly digest, a message for each post that becomes ready, and (by email) the white-label weekly report, all to the client's own channel. The proposal lists the alerts it would create; approving it in the app creates them. Alerts already there for that client and channel are left as they are.

A full-access key (ss_sk_…), or an editor or owner signed in.

Request body

JSON, sent with Content-Type: application/json.

NameTypeDescription
project required string The client brand's project id.
channel required string
One of: email slack discord teams
target required string
up to 500 characters
Where the client's updates go.
pieces array of string digest (weekly), ready (each ready post), report (weekly white-label report, email only). Default digest and ready.
One of: digest ready report
hour integer
0–23
Local hour for the weekly pieces (default 9).
weekday integer
0–6
0 Sunday to 6 Saturday (default 1, Monday).

Returns

{ data: Action, approval }

Example

curl -X POST "https://sniffington.com/api/v1/actions/client-routing" \
  -H "Authorization: Bearer $SCOUT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"project":"…","channel":"email","target":"…"}'