List campaigns

Lists the campaigns this brand has on Scout, with how many creators are on each and when applications close. signedCreators counts the people scouty_list_applicants lists for that campaign: creators the team accepted or has still to accept, signed or not, and creators in or through the activation flow, each person once.

GEThttps://api.tryscouty.com/v1/campaigns

Scopecampaigns:read
Read
MCP toolscouty_list_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

Query parameters

Name Type Required Description

Name	Type	Required	Description
`status`	`string`	Optional	Only campaigns in this publish state. Every campaign when omitted. One of `draft` `published` `paused`

status

string

Optional

Only campaigns in this publish state. Every campaign when omitted.

One of draft published paused

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
400 Bad Request	`invalid_request`	The request was not the shape this capability takes, or its body was not JSON.
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.
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?status=published", { 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", headers={"Authorization": f"Bearer {token}"}, params={"status": "published"}, ) print(response.json())

{ "campaigns": [ { "campaignId": 42, "brand": "Acme", "title": "Acme Spring launch", "status": "published", "signedCreators": 3, "applicationDeadline": "2026-10-31" } ] }