Activate Campaign

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

Required Scopes: `campaigns:write`

Body

Posting handle; must start with @

string (date)

YYYY-MM-DD, when the creator will post

Response

boolean

true on success

object

child attributes

string (uuid)

The activation record

string

ACTIVE

As submitted

string (date) | null

null when omitted from the request

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"
  }
}

Authentication

Campaign

Troubleshooting

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

Required Scopes: `campaigns:write`

Body

Response

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

​Required Scopes: campaigns:write

​Body

​Response

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

Required Scopes: `campaigns:write`

Body

Response