---
title: "Add Account"
method: POST
path: "/creator/accounts"
tags: ["creator"]
---

# Add Account

`POST /creator/accounts`

## Request body

- AddAccountRequest
  - `platform` 'tiktok' | 'instagram' | 'youtube', required — The social platforms a creator account can live on. A StrEnum, so `match` over it is exhaustiveness-checked and members compare equal to the plain strings that a Text column reads back. The column MUST stay `mapped_column(Text)`: left to infer, SQLAlchemy renders an Enum annotation as a native database ENUM over the MEMBER NAMES ("TIKTOK"), which is both a migration and a different stored value.
  - `handle` string, required

## Response `200`

Successful Response

- union
  - AccountAdded
    - `kind` 'added'
    - `account` Account, required
      - `id` string, required
      - `platform` string, required
      - `handle` string, required
      - `is_active` boolean, required
      - `followers` integer, nullable, required
      - `avatar_url` string, nullable, required
      - `added_at` string, date-time, required
  - AccountInvalid
    - `kind` 'invalid'
    - `message` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/stardrift/apis/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stardrift/fastapi/revisions/00746572572a/schema)