Get a campaign's activation

Reads the activation flow for one campaign: whether it is published, whether creators are enrolled by the team or automatically, the titles of its steps, and where each creator has got to. The creators are a page at a time. A token without the creators:read scope gets the flow without them, and creatorsOmitted says so.

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

Scopecampaigns:read
Read
MCP toolscouty_get_activation

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 to read.

Query parameters

Name	Type	Required	Description
`cursor`	`string`	Optional	The nextCursor from the previous page of creators.
`limit`	`integer`	Optional	Creators per page, 1 to 100. 50 by default.

Pagination

This list comes a page at a time, in creators. Send limit (1 to 100, 50 by default) and pass the answer's nextCursor back as cursor for the next page. nextCursor is null on the last page.

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.
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?limit=50", { 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", headers={"Authorization": f"Bearer {token}"}, params={"limit": 50}, ) print(response.json())

{ "campaignId": 42, "flow": { "status": "published", "publishedAt": "2026-09-16T10:00:00.000Z", "publishedVersion": 2, "unpublishedChanges": false, "joinCode": "JOIN ACME#42", "hostedLink": "https://tryscouty.com/a/42-example", "deadlineDays": 7, "steps": [ { "position": 1, "title": "Join the Discord server" }, { "position": 2, "title": "Post your first video" } ] }, "mode": "manual", "creators": [ { "memberId": 7, "name": "Sample Creator", "activation": { "state": "active", "stepTitle": "Join the Discord server", "timeLeft": "3 days left" }, "discordHandle": "creator_handle" } ], "nextCursor": null }