---
title: "List TikTok drafts"
method: GET
path: "/v1/workspaces/{workspaceId}/ads/tiktok/{accountId}/drafts"
tags: ["Ads"]
---

# List TikTok drafts

`GET /v1/workspaces/{workspaceId}/ads/tiktok/{accountId}/drafts`

## Request

- Base URL: `https://api.maevesocial.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maevesocial.com/v1/workspaces/{workspaceId}/ads/tiktok/{accountId}/drafts`
- Auth: HTTP bearer

List saved TikTok drafts with bounded pagination.

## Path parameters

- `accountId` string, required
- `workspaceId` string, uuid, required

## Response `200`

List TikTok drafts

- object
  - `data` object, required
    - `account` object, required
      - `id` string, required
      - `platform` 'meta' | 'tiktok' | 'linkedin' | 'google' | 'pinterest', required
      - `providerAccountId` string, required: The account ID the platform uses.
      - `name` string, nullable, required
      - `currency` string, nullable, required
      - `timezone` string, nullable, required: IANA timezone the platform reports this account in.
      - `isEnabled` boolean, required
      - `credentialStatus` 'active' | 'revoked', required
    - `money` object, required
      - `unit` 'micros', required
      - `microsPerCurrencyUnit` 1000000, required
      - `currency` string, nullable, required: ISO currency of the ad account.
    - `drafts` object[], required
      - `appUrl` string, uri
      - `id` string, uuid, required
      - `accountId` string, uuid, required
      - `name` string, required
      - `status` 'draft' | 'frozen' | 'archived', required
      - `currentStep` integer, required
      - `revision` integer, required
      - `specification` object, required
        - `schemaVersion` 1, required
        - `campaignName` string, nullable, required
        - `adGroupName` string, nullable, required
        - `identity` object, nullable, required
          - `id` string, required
          - `type` 'TT_USER' | 'BC_AUTH_TT', required
          - `authorizedBcId` string, nullable
          - `displayName` string, required
        - `objective` 'TRAFFIC' | 'VIDEO_VIEWS' | 'REACH' | 'ENGAGEMENT', nullable, required
        - `communityGoal` 'FOLLOWERS' | 'PAGE_VISIT', nullable
        - `communityBidMicros` string, nullable
        - `frequencyCap` object, nullable
          - `impressions` integer, required
          - `days` integer, required
        - `targeting` object, nullable, required
          - `locationIds` string[], required
          - `gender` 'GENDER_UNLIMITED' | 'GENDER_MALE' | 'GENDER_FEMALE', required
          - `ageGroups` string[], required
        - `budget` union, required
          - object
            - `mode` 'lifetime'
            - `lifetimeMicros` string, required
            - `currency` string, required
            - `level` 'adgroup' | 'campaign'
          - object
            - `mode` 'daily', required
            - `dailyMicros` string, required
            - `currency` string, required
            - `level` 'adgroup' | 'campaign'
        - `flight` object, nullable, required
          - `ongoing` boolean
          - `startAt` string, required
          - `endAt` string, required
          - `timezone` string, required
        - `delivery` object
          - `searchAds` boolean, required
          - `allowComments` boolean, required
          - `allowDownloads` boolean, required
          - `allowSharing` boolean, required
        - `ads` object[], required
          - `key` string, uuid, required
          - `name` string, required
          - `videoMediaId` string, required
          - `coverMediaId` string, required
          - `suggestedCover` object, nullable
            - `videoId` string, required
            - `imageId` string, required
          - `text` string, required
          - `callToAction` '' | 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'CONTACT_US' | 'DOWNLOAD_NOW' | 'VIEW_PROFILE', required
          - `destinationUrl` string, nullable
          - `tiktokPageCategory` 'PROFILE_PAGE' | 'OTHER_TIKTOK_PAGE' | 'TIKTOK_INSTANT_PAGE', nullable
          - `instantPageId` string, nullable
      - `publicationId` string, uuid, nullable, required
      - `publishedAt` string, nullable, required
      - `createdAt` string, required
      - `updatedAt` string, required
    - `page` object, required
      - `limit` integer, required
      - `offset` integer, required
      - `total` integer, required
      - `hasMore` boolean, required
  - `meta` unknown, required

---

[API](https://skmtc.dev/maevesocial/apis/maeve-social-api.md) · [All operations](https://skmtc.dev/maevesocial/apis/maeve-social-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maevesocial/apis/maeve-social-api/revisions/1b00fd7e4b15?raw)