---
title: "Publish Social Post"
method: POST
path: "/social-publishing/posts"
---

# Publish Social Post

`POST /social-publishing/posts`

## Request

- Base URL: `https://api.tellers.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tellers.ai/social-publishing/posts`
- Auth: none declared

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Request body

- SocialPublishPostRequest
  - `asset_id` string, required
  - `platforms` string[], required
  - `title` string, nullable
  - `description` string
  - `scheduled_date` string, date-time, nullable
  - `youtube_privacy` 'public' | 'unlisted' | 'private', nullable

## Response `200`

Successful Response

- SocialPublishPostResponse
  - `status` string, required
  - `request_id` string, nullable
  - `job_id` string, nullable
  - `provider_response` object

## Other responses

- `422`: Validation Error

---

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