> ## Documentation Index
> Fetch the complete documentation index at: https://docs.storytime.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Activate Campaign

<Columns cols={2}>
  <Column>
    ### Activate a campaign for a creator. Requires an `Idempotency-Key` header (any unique string).

    #### Required Scopes: `campaigns:write`

    #### Body

    <ParamField body="socialUsername" type="string" required>
      Posting handle; must start with `@`
    </ParamField>

    <ParamField body="plannedPostAt" type="string (date)">
      `YYYY-MM-DD`, when the creator will post
    </ParamField>

    #### Response

    <ResponseField name="ok" type="boolean">
      true on success
    </ResponseField>

    <ResponseField name="activation" type="object">
      <Accordion title="child attributes" defaultOpen iconType="regular">
        <ResponseField name="id" type="string (uuid)">
          The activation record
        </ResponseField>

        <ResponseField name="status" type="string">
          `ACTIVE`
        </ResponseField>

        <ResponseField name="socialUsername" type="string">
          As submitted
        </ResponseField>

        <ResponseField name="plannedPostAt" type="string (date) | null">
          `null` when omitted from the request
        </ResponseField>

        <ResponseField name="activatedAt" type="string (timestamp)">
          ISO 8601, UTC
        </ResponseField>
      </Accordion>
    </ResponseField>

    <Note>
      Replaying the same `Idempotency-Key` with the same body returns the original response; reusing it with a different body returns `409 IDEMPOTENCY_CONFLICT`.
    </Note>
  </Column>

  <Column>
    ```shellscript /v1/creators/<creatorId>/campaigns/<campaignId>/activate wrap theme={null}
    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"}'
    ```

    ```json 200 theme={null}
    {
      "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"
      }
    }
    ```
  </Column>
</Columns>