List the campaigns on the connected SideShift account

Lists the campaigns on the SideShift account this campaign is connected to, as ids and names, for choosing which one it maps to. error is "unavailable" when SideShift could not be asked.

GEThttps://api.tryscouty.com/v1/campaigns/{campaignId}/activation/sideshift/campaigns

Scopecampaigns:read
Read
MCP toolscouty_list_sideshift_campaigns

Markdown version for your agent

Authorization

Send a Scouty token as a bearer token in the Authorization header. The token needs the campaigns:read scope, or the call answers 403 insufficient_scope. Tokens and scopes

Authorization: Bearer $SCOUTY_TOKEN

Path parameters

Name	Type	Required	Description
`campaignId`	`integer`	Required	The campaign whose activation flow this is about.

Errors

A refusal answers { "error": { "code", "message" } }. Branch on code; the message is for a person. Every error and its fix

Status	error.code	Meaning
401 Unauthorized	`missing_token` `invalid_token` `token_revoked` `token_expired` `token_orphaned`	No token, or one that is not recognized, revoked or expired.
403 Forbidden	`insufficient_scope` `wrong_principal`	The token does not carry the scope this capability needs.
404 Not Found	`not_found`	No such route, or no such campaign for this client.
429 Too Many Requests	`rate_limited`	Too many requests this minute. Retry-After says how long is left.

const response = await fetch("https://api.tryscouty.com/v1/campaigns/42/activation/sideshift/campaigns", { headers: { Authorization: `Bearer ${process.env.SCOUTY_TOKEN}`, }, }); console.log(await response.json());

import os import requests token = os.environ["SCOUTY_TOKEN"] response = requests.get( "https://api.tryscouty.com/v1/campaigns/42/activation/sideshift/campaigns", headers={"Authorization": f"Bearer {token}"}, ) print(response.json())

{ "campaignId": 42, "connected": true, "campaigns": [ { "id": "ss-1", "name": "Acme Spring" }, { "id": "ss-2", "name": "Acme Summer" } ], "chosen": "ss-1" }