---
title: "Queue a post on a managed account"
method: POST
path: "/api/managed-accounts/{id}/posts"
tags: ["Managed Accounts"]
---

# Queue a post on a managed account

`POST /api/managed-accounts/{id}/posts`

## Request

- Base URL: `https://www.vidguy.ai`
- URL: `https://www.vidguy.ai/api/managed-accounts/{id}/posts`
- Auth: HTTP bearer

Posts are booked for a day (`queueFor`, default the earliest open day) and go live that day or the next. At least a day's notice, 2 posts per account per day, charged per post. Check capacity first.

## Path parameters

- `id` string, required

## Request body

- PublishToManagedAccountRequest
  - `caption` string, required
  - `queueFor` string: YYYY-MM-DD (UTC).
  - `sourceProjectId` string, uuid
  - `videoUrl` string, uri
  - `imageUrls` string[]
  - `musicLink` string: TikTok sound link, or Instagram audio link / song name.
  - `idempotencyKey` string: Makes retries safe.

## Response `200`

Queued.

- object
  - `ok` boolean, required
  - `post` ManagedPost, required
    - `id` string, uuid, required
    - `status` 'scheduled' | 'pending' | 'posted' | 'failed' | 'deleted', required
    - `caption` string, nullable, required
    - `sourceAssetUrl` string, nullable, required
    - `publicPostUrl` string, nullable, required
    - `musicLink` string, nullable, required
    - `scheduledAt` string, nullable, required
    - `postedAt` string, nullable, required
    - `views` integer, nullable, required
    - `likes` integer, nullable, required
    - `comments` integer, nullable, required
    - `createdAt` string, required

## Other responses

- `400`: Invalid request.
- `401`: Missing or invalid API key.
- `402`: Not enough credits.
- `404`: Not found.
- `409`: Account not ready or day full.
- `502`: Service unavailable.

---

[API](https://skmtc.dev/vidguy/apis/vidguy-snacks-api.md) · [All operations](https://skmtc.dev/vidguy/apis/vidguy-snacks-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vidguy/apis/vidguy-snacks-api/revisions/ad6855539a1a?raw)