Criar posts em lote
curl --request POST \
--url https://post.chatclean.com.br/api/posts/batch \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"status": "scheduled",
"queue": "next",
"content": "Nossas novidades de novembro já estão no ar.",
"media": [
{
"upload_token": "4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b",
"alt": "Capa das novidades"
}
],
"destinations": [
{
"social_account_id": "9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54",
"content_type": "x_post"
},
{
"social_account_id": "9c8b7a65-5e4f-4a3b-9c2d-1e0f9a8b7c65",
"content_type": "pinterest_pin",
"content": "Tudo o que lançamos em novembro, num pin só.",
"meta": {
"board_id": "1022106146620830917",
"title": "Novidades de novembro",
"link": "https://chatclean.com.br/blog"
}
}
]
}
'import requests
url = "https://post.chatclean.com.br/api/posts/batch"
payload = {
"status": "scheduled",
"queue": "next",
"content": "Nossas novidades de novembro já estão no ar.",
"media": [
{
"upload_token": "4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b",
"alt": "Capa das novidades"
}
],
"destinations": [
{
"social_account_id": "9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54",
"content_type": "x_post"
},
{
"social_account_id": "9c8b7a65-5e4f-4a3b-9c2d-1e0f9a8b7c65",
"content_type": "pinterest_pin",
"content": "Tudo o que lançamos em novembro, num pin só.",
"meta": {
"board_id": "1022106146620830917",
"title": "Novidades de novembro",
"link": "https://chatclean.com.br/blog"
}
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
status: 'scheduled',
queue: 'next',
content: 'Nossas novidades de novembro já estão no ar.',
media: [
{
upload_token: '4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b',
alt: 'Capa das novidades'
}
],
destinations: [
{
social_account_id: '9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54',
content_type: 'x_post'
},
{
social_account_id: '9c8b7a65-5e4f-4a3b-9c2d-1e0f9a8b7c65',
content_type: 'pinterest_pin',
content: 'Tudo o que lançamos em novembro, num pin só.',
meta: {
board_id: '1022106146620830917',
title: 'Novidades de novembro',
link: 'https://chatclean.com.br/blog'
}
}
]
})
};
fetch('https://post.chatclean.com.br/api/posts/batch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://post.chatclean.com.br/api/posts/batch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'status' => 'scheduled',
'queue' => 'next',
'content' => 'Nossas novidades de novembro já estão no ar.',
'media' => [
[
'upload_token' => '4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b',
'alt' => 'Capa das novidades'
]
],
'destinations' => [
[
'social_account_id' => '9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54',
'content_type' => 'x_post'
],
[
'social_account_id' => '9c8b7a65-5e4f-4a3b-9c2d-1e0f9a8b7c65',
'content_type' => 'pinterest_pin',
'content' => 'Tudo o que lançamos em novembro, num pin só.',
'meta' => [
'board_id' => '1022106146620830917',
'title' => 'Novidades de novembro',
'link' => 'https://chatclean.com.br/blog'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://post.chatclean.com.br/api/posts/batch"
payload := strings.NewReader("{\n \"status\": \"scheduled\",\n \"queue\": \"next\",\n \"content\": \"Nossas novidades de novembro já estão no ar.\",\n \"media\": [\n {\n \"upload_token\": \"4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b\",\n \"alt\": \"Capa das novidades\"\n }\n ],\n \"destinations\": [\n {\n \"social_account_id\": \"9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54\",\n \"content_type\": \"x_post\"\n },\n {\n \"social_account_id\": \"9c8b7a65-5e4f-4a3b-9c2d-1e0f9a8b7c65\",\n \"content_type\": \"pinterest_pin\",\n \"content\": \"Tudo o que lançamos em novembro, num pin só.\",\n \"meta\": {\n \"board_id\": \"1022106146620830917\",\n \"title\": \"Novidades de novembro\",\n \"link\": \"https://chatclean.com.br/blog\"\n }\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://post.chatclean.com.br/api/posts/batch")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"status\": \"scheduled\",\n \"queue\": \"next\",\n \"content\": \"Nossas novidades de novembro já estão no ar.\",\n \"media\": [\n {\n \"upload_token\": \"4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b\",\n \"alt\": \"Capa das novidades\"\n }\n ],\n \"destinations\": [\n {\n \"social_account_id\": \"9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54\",\n \"content_type\": \"x_post\"\n },\n {\n \"social_account_id\": \"9c8b7a65-5e4f-4a3b-9c2d-1e0f9a8b7c65\",\n \"content_type\": \"pinterest_pin\",\n \"content\": \"Tudo o que lançamos em novembro, num pin só.\",\n \"meta\": {\n \"board_id\": \"1022106146620830917\",\n \"title\": \"Novidades de novembro\",\n \"link\": \"https://chatclean.com.br/blog\"\n }\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://post.chatclean.com.br/api/posts/batch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"status\": \"scheduled\",\n \"queue\": \"next\",\n \"content\": \"Nossas novidades de novembro já estão no ar.\",\n \"media\": [\n {\n \"upload_token\": \"4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b\",\n \"alt\": \"Capa das novidades\"\n }\n ],\n \"destinations\": [\n {\n \"social_account_id\": \"9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54\",\n \"content_type\": \"x_post\"\n },\n {\n \"social_account_id\": \"9c8b7a65-5e4f-4a3b-9c2d-1e0f9a8b7c65\",\n \"content_type\": \"pinterest_pin\",\n \"content\": \"Tudo o que lançamos em novembro, num pin só.\",\n \"meta\": {\n \"board_id\": \"1022106146620830917\",\n \"title\": \"Novidades de novembro\",\n \"link\": \"https://chatclean.com.br/blog\"\n }\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"posts": [
{
"id": "9d3c1f2a-6b4e-4c8a-9f1e-2a7b5c8d0e41",
"post_group_id": "9d3c1f29-e0a1-4b7c-8d2e-5f6a7b8c9d03",
"author": {
"id": "9b1e2d3c-4f5a-4b6c-8d7e-9f0a1b2c3d4e",
"name": "Ana Souza"
},
"content": "Nossas novidades de novembro já estão no ar.",
"media": [
{
"id": "9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
"path": "medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
"url": "https://post.chatclean.com.br/storage/medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
"type": "image",
"mime_type": "image/jpeg",
"original_filename": "lancamento.jpg",
"size": 482113,
"meta": {
"width": 1080,
"height": 1350,
"alt_text": "Capa das novidades"
}
}
],
"status": "scheduled",
"schedule_mode": "queue",
"scheduled_at": "2026-11-07 12:00:00",
"published_at": null,
"approval_requested_by": null,
"approval_requested_at": null,
"approved_by": null,
"approved_at": null,
"recurrence": null,
"origin": "trypost",
"platforms": [
{
"id": "9d3c1f2b-1a2b-4c3d-8e4f-5a6b7c8d9e0f",
"platform": "x",
"content_type": "x_post",
"meta": [],
"status": "pending",
"enabled": true,
"platform_url": null,
"published_at": null,
"error_message": null,
"display_name": "PostClean",
"display_username": "postclean",
"display_avatar": "https://pbs.twimg.com/profile_images/1790000000000000000/avatar_400x400.jpg",
"social_account": {
"id": "9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54",
"platform": "x",
"display_name": "PostClean",
"username": "postclean",
"status": "connected",
"has_posting_schedule": true,
"timezone": "America/Sao_Paulo",
"posting_goal": 5,
"max_content_length": 280,
"long_posts": false,
"verified_badge": null
}
}
],
"labels": [],
"created_at": "2026-11-06 13:20:11",
"updated_at": "2026-11-06 13:20:11"
},
{
"id": "9d3c1f2a-7c5f-4d9b-8e2f-3b8c6d9e1f52",
"post_group_id": "9d3c1f29-e0a1-4b7c-8d2e-5f6a7b8c9d03",
"author": {
"id": "9b1e2d3c-4f5a-4b6c-8d7e-9f0a1b2c3d4e",
"name": "Ana Souza"
},
"content": "Tudo o que lançamos em novembro, num pin só.",
"media": [
{
"id": "9d3c1f31-9b0c-4d1e-8f2a-3b4c5d6e7f80",
"path": "medias/9d3c1f31-9b0c-4d1e-8f2a-3b4c5d6e7f80.jpg",
"url": "https://post.chatclean.com.br/storage/medias/9d3c1f31-9b0c-4d1e-8f2a-3b4c5d6e7f80.jpg",
"type": "image",
"mime_type": "image/jpeg",
"original_filename": "lancamento.jpg",
"size": 482113,
"meta": {
"width": 1080,
"height": 1350,
"alt_text": "Capa das novidades"
}
}
],
"status": "scheduled",
"schedule_mode": "queue",
"scheduled_at": "2026-11-07 12:00:00",
"published_at": null,
"approval_requested_by": null,
"approval_requested_at": null,
"approved_by": null,
"approved_at": null,
"recurrence": null,
"origin": "trypost",
"platforms": [
{
"id": "9d3c1f2b-2b3c-4d4e-9f5a-6b7c8d9e0f1a",
"platform": "pinterest",
"content_type": "pinterest_pin",
"meta": {
"board_id": "1022106146620830917",
"title": "Novidades de novembro",
"link": "https://chatclean.com.br/blog"
},
"status": "pending",
"enabled": true,
"platform_url": null,
"published_at": null,
"error_message": null,
"display_name": "PostClean",
"display_username": "postclean",
"display_avatar": null,
"social_account": {
"id": "9c8b7a65-5e4f-4a3b-9c2d-1e0f9a8b7c65",
"platform": "pinterest",
"display_name": "PostClean",
"username": "postclean",
"status": "connected",
"has_posting_schedule": true,
"timezone": "America/Sao_Paulo",
"posting_goal": 5,
"max_content_length": 800,
"long_posts": false,
"verified_badge": null
}
}
],
"labels": [],
"created_at": "2026-11-06 13:20:11",
"updated_at": "2026-11-06 13:20:11"
}
]
}{
"message": "Unauthenticated."
}{
"message": "Active subscription required."
}{
"message": "<string>"
}{
"message": "<string>"
}{
"message": "<string>",
"errors": {}
}{
"name": "rate_limit_exceeded",
"message": "Rate limit exceeded. Please retry after 30 seconds."
}Posts
Criar posts em lote
Cria um post independente para cada destino, como o app faz quando vários canais são escolhidos. Os posts compartilham o mesmo post_group_id. Cada destino pode trocar o content e a media compartilhados e ter seu próprio content_type e meta.
status: scheduled agenda todos os posts em scheduled_at ou na fila de cada canal (queue: next ou top). Um horário específico da fila (queue_slot) não é aceito aqui: use POST /posts ou PUT /channels/{account}/queue/slot.
destinations[].meta segue as mesmas regras por rede do meta de um post (veja PlatformMeta), checadas com a rede de cada destino; os erros aparecem em destinations.N.* (por exemplo destinations.1.meta.board_id). Para agendar ou publicar, cada destino precisa das configurações obrigatórias e de texto ou mídia. Cada conta pode aparecer uma vez só.
A chave de API age como o usuário que a criou. Só admins do workspace criam chaves, e admins publicam direto, então o post não fica pending_approval.
Responde 409 quando a fila de algum dos canais está sendo alterada por outra requisição; tente de novo.
POST
/
posts
/
batch
Criar posts em lote
curl --request POST \
--url https://post.chatclean.com.br/api/posts/batch \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"status": "scheduled",
"queue": "next",
"content": "Nossas novidades de novembro já estão no ar.",
"media": [
{
"upload_token": "4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b",
"alt": "Capa das novidades"
}
],
"destinations": [
{
"social_account_id": "9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54",
"content_type": "x_post"
},
{
"social_account_id": "9c8b7a65-5e4f-4a3b-9c2d-1e0f9a8b7c65",
"content_type": "pinterest_pin",
"content": "Tudo o que lançamos em novembro, num pin só.",
"meta": {
"board_id": "1022106146620830917",
"title": "Novidades de novembro",
"link": "https://chatclean.com.br/blog"
}
}
]
}
'import requests
url = "https://post.chatclean.com.br/api/posts/batch"
payload = {
"status": "scheduled",
"queue": "next",
"content": "Nossas novidades de novembro já estão no ar.",
"media": [
{
"upload_token": "4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b",
"alt": "Capa das novidades"
}
],
"destinations": [
{
"social_account_id": "9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54",
"content_type": "x_post"
},
{
"social_account_id": "9c8b7a65-5e4f-4a3b-9c2d-1e0f9a8b7c65",
"content_type": "pinterest_pin",
"content": "Tudo o que lançamos em novembro, num pin só.",
"meta": {
"board_id": "1022106146620830917",
"title": "Novidades de novembro",
"link": "https://chatclean.com.br/blog"
}
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
status: 'scheduled',
queue: 'next',
content: 'Nossas novidades de novembro já estão no ar.',
media: [
{
upload_token: '4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b',
alt: 'Capa das novidades'
}
],
destinations: [
{
social_account_id: '9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54',
content_type: 'x_post'
},
{
social_account_id: '9c8b7a65-5e4f-4a3b-9c2d-1e0f9a8b7c65',
content_type: 'pinterest_pin',
content: 'Tudo o que lançamos em novembro, num pin só.',
meta: {
board_id: '1022106146620830917',
title: 'Novidades de novembro',
link: 'https://chatclean.com.br/blog'
}
}
]
})
};
fetch('https://post.chatclean.com.br/api/posts/batch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://post.chatclean.com.br/api/posts/batch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'status' => 'scheduled',
'queue' => 'next',
'content' => 'Nossas novidades de novembro já estão no ar.',
'media' => [
[
'upload_token' => '4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b',
'alt' => 'Capa das novidades'
]
],
'destinations' => [
[
'social_account_id' => '9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54',
'content_type' => 'x_post'
],
[
'social_account_id' => '9c8b7a65-5e4f-4a3b-9c2d-1e0f9a8b7c65',
'content_type' => 'pinterest_pin',
'content' => 'Tudo o que lançamos em novembro, num pin só.',
'meta' => [
'board_id' => '1022106146620830917',
'title' => 'Novidades de novembro',
'link' => 'https://chatclean.com.br/blog'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://post.chatclean.com.br/api/posts/batch"
payload := strings.NewReader("{\n \"status\": \"scheduled\",\n \"queue\": \"next\",\n \"content\": \"Nossas novidades de novembro já estão no ar.\",\n \"media\": [\n {\n \"upload_token\": \"4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b\",\n \"alt\": \"Capa das novidades\"\n }\n ],\n \"destinations\": [\n {\n \"social_account_id\": \"9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54\",\n \"content_type\": \"x_post\"\n },\n {\n \"social_account_id\": \"9c8b7a65-5e4f-4a3b-9c2d-1e0f9a8b7c65\",\n \"content_type\": \"pinterest_pin\",\n \"content\": \"Tudo o que lançamos em novembro, num pin só.\",\n \"meta\": {\n \"board_id\": \"1022106146620830917\",\n \"title\": \"Novidades de novembro\",\n \"link\": \"https://chatclean.com.br/blog\"\n }\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://post.chatclean.com.br/api/posts/batch")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"status\": \"scheduled\",\n \"queue\": \"next\",\n \"content\": \"Nossas novidades de novembro já estão no ar.\",\n \"media\": [\n {\n \"upload_token\": \"4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b\",\n \"alt\": \"Capa das novidades\"\n }\n ],\n \"destinations\": [\n {\n \"social_account_id\": \"9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54\",\n \"content_type\": \"x_post\"\n },\n {\n \"social_account_id\": \"9c8b7a65-5e4f-4a3b-9c2d-1e0f9a8b7c65\",\n \"content_type\": \"pinterest_pin\",\n \"content\": \"Tudo o que lançamos em novembro, num pin só.\",\n \"meta\": {\n \"board_id\": \"1022106146620830917\",\n \"title\": \"Novidades de novembro\",\n \"link\": \"https://chatclean.com.br/blog\"\n }\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://post.chatclean.com.br/api/posts/batch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"status\": \"scheduled\",\n \"queue\": \"next\",\n \"content\": \"Nossas novidades de novembro já estão no ar.\",\n \"media\": [\n {\n \"upload_token\": \"4f6c2b1e-8d3a-4e5f-9a7b-1c2d3e4f5a6b\",\n \"alt\": \"Capa das novidades\"\n }\n ],\n \"destinations\": [\n {\n \"social_account_id\": \"9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54\",\n \"content_type\": \"x_post\"\n },\n {\n \"social_account_id\": \"9c8b7a65-5e4f-4a3b-9c2d-1e0f9a8b7c65\",\n \"content_type\": \"pinterest_pin\",\n \"content\": \"Tudo o que lançamos em novembro, num pin só.\",\n \"meta\": {\n \"board_id\": \"1022106146620830917\",\n \"title\": \"Novidades de novembro\",\n \"link\": \"https://chatclean.com.br/blog\"\n }\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"posts": [
{
"id": "9d3c1f2a-6b4e-4c8a-9f1e-2a7b5c8d0e41",
"post_group_id": "9d3c1f29-e0a1-4b7c-8d2e-5f6a7b8c9d03",
"author": {
"id": "9b1e2d3c-4f5a-4b6c-8d7e-9f0a1b2c3d4e",
"name": "Ana Souza"
},
"content": "Nossas novidades de novembro já estão no ar.",
"media": [
{
"id": "9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
"path": "medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
"url": "https://post.chatclean.com.br/storage/medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
"type": "image",
"mime_type": "image/jpeg",
"original_filename": "lancamento.jpg",
"size": 482113,
"meta": {
"width": 1080,
"height": 1350,
"alt_text": "Capa das novidades"
}
}
],
"status": "scheduled",
"schedule_mode": "queue",
"scheduled_at": "2026-11-07 12:00:00",
"published_at": null,
"approval_requested_by": null,
"approval_requested_at": null,
"approved_by": null,
"approved_at": null,
"recurrence": null,
"origin": "trypost",
"platforms": [
{
"id": "9d3c1f2b-1a2b-4c3d-8e4f-5a6b7c8d9e0f",
"platform": "x",
"content_type": "x_post",
"meta": [],
"status": "pending",
"enabled": true,
"platform_url": null,
"published_at": null,
"error_message": null,
"display_name": "PostClean",
"display_username": "postclean",
"display_avatar": "https://pbs.twimg.com/profile_images/1790000000000000000/avatar_400x400.jpg",
"social_account": {
"id": "9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54",
"platform": "x",
"display_name": "PostClean",
"username": "postclean",
"status": "connected",
"has_posting_schedule": true,
"timezone": "America/Sao_Paulo",
"posting_goal": 5,
"max_content_length": 280,
"long_posts": false,
"verified_badge": null
}
}
],
"labels": [],
"created_at": "2026-11-06 13:20:11",
"updated_at": "2026-11-06 13:20:11"
},
{
"id": "9d3c1f2a-7c5f-4d9b-8e2f-3b8c6d9e1f52",
"post_group_id": "9d3c1f29-e0a1-4b7c-8d2e-5f6a7b8c9d03",
"author": {
"id": "9b1e2d3c-4f5a-4b6c-8d7e-9f0a1b2c3d4e",
"name": "Ana Souza"
},
"content": "Tudo o que lançamos em novembro, num pin só.",
"media": [
{
"id": "9d3c1f31-9b0c-4d1e-8f2a-3b4c5d6e7f80",
"path": "medias/9d3c1f31-9b0c-4d1e-8f2a-3b4c5d6e7f80.jpg",
"url": "https://post.chatclean.com.br/storage/medias/9d3c1f31-9b0c-4d1e-8f2a-3b4c5d6e7f80.jpg",
"type": "image",
"mime_type": "image/jpeg",
"original_filename": "lancamento.jpg",
"size": 482113,
"meta": {
"width": 1080,
"height": 1350,
"alt_text": "Capa das novidades"
}
}
],
"status": "scheduled",
"schedule_mode": "queue",
"scheduled_at": "2026-11-07 12:00:00",
"published_at": null,
"approval_requested_by": null,
"approval_requested_at": null,
"approved_by": null,
"approved_at": null,
"recurrence": null,
"origin": "trypost",
"platforms": [
{
"id": "9d3c1f2b-2b3c-4d4e-9f5a-6b7c8d9e0f1a",
"platform": "pinterest",
"content_type": "pinterest_pin",
"meta": {
"board_id": "1022106146620830917",
"title": "Novidades de novembro",
"link": "https://chatclean.com.br/blog"
},
"status": "pending",
"enabled": true,
"platform_url": null,
"published_at": null,
"error_message": null,
"display_name": "PostClean",
"display_username": "postclean",
"display_avatar": null,
"social_account": {
"id": "9c8b7a65-5e4f-4a3b-9c2d-1e0f9a8b7c65",
"platform": "pinterest",
"display_name": "PostClean",
"username": "postclean",
"status": "connected",
"has_posting_schedule": true,
"timezone": "America/Sao_Paulo",
"posting_goal": 5,
"max_content_length": 800,
"long_posts": false,
"verified_badge": null
}
}
],
"labels": [],
"created_at": "2026-11-06 13:20:11",
"updated_at": "2026-11-06 13:20:11"
}
]
}{
"message": "Unauthenticated."
}{
"message": "Active subscription required."
}{
"message": "<string>"
}{
"message": "<string>"
}{
"message": "<string>",
"errors": {}
}{
"name": "rate_limit_exceeded",
"message": "Rate limit exceeded. Please retry after 30 seconds."
}Authorizations
Chave de API do workspace, criada em Configurações > Chaves de API.
Body
application/json
draft salva um rascunho editável. scheduled agenda em scheduled_at ou na fila do canal (queue). publishing publica agora.
Available options:
draft, scheduled, publishing Um item por conta social; cada conta uma vez só.
Minimum array length:
1Show child attributes
Show child attributes
Texto compartilhado, até 25000 caracteres. Com status scheduled ou publishing, o texto de cada destino também precisa caber no limite da conta (max_content_length), medido no texto que a rede recebe.
Maximum string length:
25000Mídias compartilhadas. Mídias em ordem. Cada item traz exatamente um entre upload_token, url ou id. Tipos que a rede do canal não aceita são recusados.
Show child attributes
Show child attributes
Quando publicar, com status: scheduled. Aceita qualquer data reconhecível; precisa estar no futuro e antes de 2038-01-19. Obrigatório com status: scheduled, a não ser que vá queue. Não combina com queue.
Posição na fila, só com status: scheduled. next pega o primeiro horário livre de cada canal; top pega o primeiro horário e empurra os posts da fila que estão atrás dele para a próxima lacuna. Todos os canais precisam ter horários de postagem (has_posting_schedule). Não combina com scheduled_at.
Available options:
next, top, null Etiquetas deste workspace, aplicadas a todos os posts.
Response
Os posts criados, na ordem de destinations.
Show child attributes
Show child attributes