---
title: "Crea un BORRADOR de posteo en Posteos (no publica: lo aprueba una persona)"
method: POST
path: "/api/v1/create_social_post_draft"
tags: ["Organic Social"]
---

# Crea un BORRADOR de posteo en Posteos (no publica: lo aprueba una persona)

`POST /api/v1/create_social_post_draft`

## Request

- Base URL: `https://api.pymaia.com`
- URL: `https://api.pymaia.com/api/v1/create_social_post_draft`
- Auth: HTTP bearer

Crea un BORRADOR de posteo en Posteos (no publica: lo aprueba una persona). Piezas por id en orden (carrusel, reel, subidas); copia cada archivo.

## Request body

- object
  - `platforms` string[], required: Redes donde va el posteo
  - `caption` string, required
  - `title` string: Nombre de la tarjeta. Repetirlo actualiza ese borrador en vez de crear otro.
  - `media_url` string, uri
  - `creative_job_id` string, uuid: job_id de una pieza de compose_static: va de imagen.
  - `piezas` string[]: Ids en orden: job_id, node_id, carrusel o upload_creative
  - `media_urls` string[]
  - `documento` string: PDF de LinkedIn (url o id)
  - `reel_en_grilla` boolean: IG: false = fuera de la grilla
  - `reel_de_prueba` 'manual' | 'automatica'
  - `scheduled_at` string: ISO-8601. Sin esto se propone en 24h.
  - `rationale` string
  - `linkedin_as_me` boolean: Publica en LinkedIn desde TU perfil
  - `entrada_id` string, uuid: Entrada de upsert_social_calendar

## Response `200`

Tool executed successfully

- object
  - `ok` boolean
  - `result` unknown
  - `duration_ms` number

## Other responses

- `400`: Invalid params or handler error
- `401`: Missing or invalid Bearer token
- `403`: Missing required scope(s) (`denied_scope`), or the tool's module is disabled for the organization (`module_disabled`, with `why`, `fix` and `module`)
- `404`: Tool not found, internal-only, or excluded for OAuth connectors
- `429`: Rate limit exceeded

---

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