Skip to main content

​
Activate a campaign for a creator. Requires an Idempotency-Key header (any unique string).

​
Required Scopes: campaigns:write

​
Body

​
socialUsername
string
required
Posting handle; must start with @
​
plannedPostAt
string (date)
YYYY-MM-DD, when the creator will post

​
Response

​
ok
boolean
true on success
​
activation
object

child attributes

​
id
string (uuid)
The activation record
​
status
string
ACTIVE
​
socialUsername
string
As submitted
​
plannedPostAt
string (date) | null
null when omitted from the request
​
activatedAt
string (timestamp)
ISO 8601, UTC
Replaying the same Idempotency-Key with the same body returns the original response; reusing it with a different body returns 409 IDEMPOTENCY_CONFLICT.
/v1/creators/<creatorId>/campaigns/<campaignId>/activate
curl -sS -X POST https://api.storytime.io/v1/creators/7d4e2a10-0000-4000-8000-000000000101/campaigns/0b1f3d3e-4c1a-4a5e-9b6a-000000000001/activate \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"socialUsername": "@yourcreator", "plannedPostAt": "2026-07-15"}'
200
{
  "ok": true,
  "activation": {
    "id": "e1f2a3b4-0000-4000-8000-000000000301",
    "campaignId": "0b1f3d3e-4c1a-4a5e-9b6a-000000000001",
    "creatorId": "7d4e2a10-0000-4000-8000-000000000101",
    "status": "ACTIVE",
    "socialUsername": "@yourcreator",
    "plannedPostAt": "2026-07-15",
    "activatedAt": "2026-07-08T18:05:12.000Z"
  }
}