Create a post
curl --request POST \
--url https://postmesh.app/api/v1/posts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"platforms": [],
"content": "",
"account_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"captions": {},
"media": [
{
"path": "<string>",
"name": "<string>"
}
],
"media_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"scheduled_at": "2023-11-07T05:31:56Z",
"network_settings": {
"reddit": {
"title": "<string>",
"subreddit": "<string>",
"flairId": "<string>",
"destinations": [
{
"subreddit": "<string>",
"title": "<string>",
"flairId": "<string>"
}
],
"nsfw": true,
"spoiler": true,
"firstComment": {
"text": "<string>",
"delayMinutes": 720
}
}
},
"settings": {},
"label_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"draft_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://postmesh.app/api/v1/posts"
payload = {
"platforms": [],
"content": "",
"account_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"captions": {},
"media": [
{
"path": "<string>",
"name": "<string>"
}
],
"media_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"scheduled_at": "2023-11-07T05:31:56Z",
"network_settings": { "reddit": {
"title": "<string>",
"subreddit": "<string>",
"flairId": "<string>",
"destinations": [
{
"subreddit": "<string>",
"title": "<string>",
"flairId": "<string>"
}
],
"nsfw": True,
"spoiler": True,
"firstComment": {
"text": "<string>",
"delayMinutes": 720
}
} },
"settings": {},
"label_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"draft_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
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({
platforms: [],
content: '',
account_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
captions: {},
media: [{path: '<string>', name: '<string>'}],
media_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
scheduled_at: '2023-11-07T05:31:56Z',
network_settings: {
reddit: {
title: '<string>',
subreddit: '<string>',
flairId: '<string>',
destinations: [{subreddit: '<string>', title: '<string>', flairId: '<string>'}],
nsfw: true,
spoiler: true,
firstComment: {text: '<string>', delayMinutes: 720}
}
},
settings: {},
label_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
draft_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
})
};
fetch('https://postmesh.app/api/v1/posts', 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://postmesh.app/api/v1/posts",
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([
'platforms' => [
],
'content' => '',
'account_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'captions' => [
],
'media' => [
[
'path' => '<string>',
'name' => '<string>'
]
],
'media_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'scheduled_at' => '2023-11-07T05:31:56Z',
'network_settings' => [
'reddit' => [
'title' => '<string>',
'subreddit' => '<string>',
'flairId' => '<string>',
'destinations' => [
[
'subreddit' => '<string>',
'title' => '<string>',
'flairId' => '<string>'
]
],
'nsfw' => true,
'spoiler' => true,
'firstComment' => [
'text' => '<string>',
'delayMinutes' => 720
]
]
],
'settings' => [
],
'label_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'draft_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]),
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://postmesh.app/api/v1/posts"
payload := strings.NewReader("{\n \"platforms\": [],\n \"content\": \"\",\n \"account_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"captions\": {},\n \"media\": [\n {\n \"path\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"media_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"scheduled_at\": \"2023-11-07T05:31:56Z\",\n \"network_settings\": {\n \"reddit\": {\n \"title\": \"<string>\",\n \"subreddit\": \"<string>\",\n \"flairId\": \"<string>\",\n \"destinations\": [\n {\n \"subreddit\": \"<string>\",\n \"title\": \"<string>\",\n \"flairId\": \"<string>\"\n }\n ],\n \"nsfw\": true,\n \"spoiler\": true,\n \"firstComment\": {\n \"text\": \"<string>\",\n \"delayMinutes\": 720\n }\n }\n },\n \"settings\": {},\n \"label_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"draft_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\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://postmesh.app/api/v1/posts")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"platforms\": [],\n \"content\": \"\",\n \"account_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"captions\": {},\n \"media\": [\n {\n \"path\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"media_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"scheduled_at\": \"2023-11-07T05:31:56Z\",\n \"network_settings\": {\n \"reddit\": {\n \"title\": \"<string>\",\n \"subreddit\": \"<string>\",\n \"flairId\": \"<string>\",\n \"destinations\": [\n {\n \"subreddit\": \"<string>\",\n \"title\": \"<string>\",\n \"flairId\": \"<string>\"\n }\n ],\n \"nsfw\": true,\n \"spoiler\": true,\n \"firstComment\": {\n \"text\": \"<string>\",\n \"delayMinutes\": 720\n }\n }\n },\n \"settings\": {},\n \"label_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"draft_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://postmesh.app/api/v1/posts")
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 \"platforms\": [],\n \"content\": \"\",\n \"account_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"captions\": {},\n \"media\": [\n {\n \"path\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"media_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"scheduled_at\": \"2023-11-07T05:31:56Z\",\n \"network_settings\": {\n \"reddit\": {\n \"title\": \"<string>\",\n \"subreddit\": \"<string>\",\n \"flairId\": \"<string>\",\n \"destinations\": [\n {\n \"subreddit\": \"<string>\",\n \"title\": \"<string>\",\n \"flairId\": \"<string>\"\n }\n ],\n \"nsfw\": true,\n \"spoiler\": true,\n \"firstComment\": {\n \"text\": \"<string>\",\n \"delayMinutes\": 720\n }\n }\n },\n \"settings\": {},\n \"label_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"draft_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"
response = http.request(request)
puts response.read_body{
"post": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "scheduled",
"platforms": [
"<string>"
],
"text": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"text_cut": true,
"scheduled_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"source": "app",
"error": "<string>",
"accounts": [
{
"platform": "<string>",
"result": "posted",
"account_id": "<string>",
"username": "<string>",
"url": "<string>",
"error": "<string>"
}
],
"label_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
},
"success": true,
"replayed": true,
"awaiting_approval": true,
"outcome_unknown": true,
"error": "<string>"
}{
"post": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "scheduled",
"platforms": [
"<string>"
],
"text": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"text_cut": true,
"scheduled_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"source": "app",
"error": "<string>",
"accounts": [
{
"platform": "<string>",
"result": "posted",
"account_id": "<string>",
"username": "<string>",
"url": "<string>",
"error": "<string>"
}
],
"label_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
},
"success": true,
"replayed": true,
"awaiting_approval": true,
"outcome_unknown": true,
"error": "<string>"
}{
"post": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "scheduled",
"platforms": [
"<string>"
],
"text": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"text_cut": true,
"scheduled_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"source": "app",
"error": "<string>",
"accounts": [
{
"platform": "<string>",
"result": "posted",
"account_id": "<string>",
"username": "<string>",
"url": "<string>",
"error": "<string>"
}
],
"label_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
},
"success": true,
"replayed": true,
"awaiting_approval": true,
"outcome_unknown": true,
"error": "<string>"
}{
"error": "<string>",
"code": "<string>",
"field": "<string>",
"retry_after": 0
}{
"error": "<string>",
"code": "<string>",
"field": "<string>",
"retry_after": 0
}{
"error": "<string>",
"code": "<string>",
"field": "<string>",
"retry_after": 0
}{
"error": "<string>",
"code": "<string>",
"field": "<string>",
"retry_after": 0
}{
"error": "<string>",
"code": "<string>",
"field": "<string>",
"retry_after": 0
}{
"error": "<string>",
"code": "<string>",
"field": "<string>",
"retry_after": 0
}{
"error": "<string>",
"code": "<string>",
"field": "<string>",
"retry_after": 0
}{
"error": "<string>",
"code": "<string>",
"field": "<string>",
"retry_after": 0
}Posts
Create a post
Posts now, or schedules the post when scheduled_at is set. Every network’s rules are checked first; a post that breaks one is refused with 400 and nothing is sent. With an API key in approval mode the post waits for you in PostMesh instead.
Needs an API key with the publish scope.
POST
/
posts
Create a post
curl --request POST \
--url https://postmesh.app/api/v1/posts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"platforms": [],
"content": "",
"account_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"captions": {},
"media": [
{
"path": "<string>",
"name": "<string>"
}
],
"media_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"scheduled_at": "2023-11-07T05:31:56Z",
"network_settings": {
"reddit": {
"title": "<string>",
"subreddit": "<string>",
"flairId": "<string>",
"destinations": [
{
"subreddit": "<string>",
"title": "<string>",
"flairId": "<string>"
}
],
"nsfw": true,
"spoiler": true,
"firstComment": {
"text": "<string>",
"delayMinutes": 720
}
}
},
"settings": {},
"label_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"draft_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://postmesh.app/api/v1/posts"
payload = {
"platforms": [],
"content": "",
"account_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"captions": {},
"media": [
{
"path": "<string>",
"name": "<string>"
}
],
"media_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"scheduled_at": "2023-11-07T05:31:56Z",
"network_settings": { "reddit": {
"title": "<string>",
"subreddit": "<string>",
"flairId": "<string>",
"destinations": [
{
"subreddit": "<string>",
"title": "<string>",
"flairId": "<string>"
}
],
"nsfw": True,
"spoiler": True,
"firstComment": {
"text": "<string>",
"delayMinutes": 720
}
} },
"settings": {},
"label_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"draft_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
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({
platforms: [],
content: '',
account_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
captions: {},
media: [{path: '<string>', name: '<string>'}],
media_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
scheduled_at: '2023-11-07T05:31:56Z',
network_settings: {
reddit: {
title: '<string>',
subreddit: '<string>',
flairId: '<string>',
destinations: [{subreddit: '<string>', title: '<string>', flairId: '<string>'}],
nsfw: true,
spoiler: true,
firstComment: {text: '<string>', delayMinutes: 720}
}
},
settings: {},
label_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
draft_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
})
};
fetch('https://postmesh.app/api/v1/posts', 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://postmesh.app/api/v1/posts",
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([
'platforms' => [
],
'content' => '',
'account_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'captions' => [
],
'media' => [
[
'path' => '<string>',
'name' => '<string>'
]
],
'media_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'scheduled_at' => '2023-11-07T05:31:56Z',
'network_settings' => [
'reddit' => [
'title' => '<string>',
'subreddit' => '<string>',
'flairId' => '<string>',
'destinations' => [
[
'subreddit' => '<string>',
'title' => '<string>',
'flairId' => '<string>'
]
],
'nsfw' => true,
'spoiler' => true,
'firstComment' => [
'text' => '<string>',
'delayMinutes' => 720
]
]
],
'settings' => [
],
'label_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'draft_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]),
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://postmesh.app/api/v1/posts"
payload := strings.NewReader("{\n \"platforms\": [],\n \"content\": \"\",\n \"account_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"captions\": {},\n \"media\": [\n {\n \"path\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"media_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"scheduled_at\": \"2023-11-07T05:31:56Z\",\n \"network_settings\": {\n \"reddit\": {\n \"title\": \"<string>\",\n \"subreddit\": \"<string>\",\n \"flairId\": \"<string>\",\n \"destinations\": [\n {\n \"subreddit\": \"<string>\",\n \"title\": \"<string>\",\n \"flairId\": \"<string>\"\n }\n ],\n \"nsfw\": true,\n \"spoiler\": true,\n \"firstComment\": {\n \"text\": \"<string>\",\n \"delayMinutes\": 720\n }\n }\n },\n \"settings\": {},\n \"label_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"draft_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\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://postmesh.app/api/v1/posts")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"platforms\": [],\n \"content\": \"\",\n \"account_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"captions\": {},\n \"media\": [\n {\n \"path\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"media_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"scheduled_at\": \"2023-11-07T05:31:56Z\",\n \"network_settings\": {\n \"reddit\": {\n \"title\": \"<string>\",\n \"subreddit\": \"<string>\",\n \"flairId\": \"<string>\",\n \"destinations\": [\n {\n \"subreddit\": \"<string>\",\n \"title\": \"<string>\",\n \"flairId\": \"<string>\"\n }\n ],\n \"nsfw\": true,\n \"spoiler\": true,\n \"firstComment\": {\n \"text\": \"<string>\",\n \"delayMinutes\": 720\n }\n }\n },\n \"settings\": {},\n \"label_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"draft_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://postmesh.app/api/v1/posts")
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 \"platforms\": [],\n \"content\": \"\",\n \"account_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"captions\": {},\n \"media\": [\n {\n \"path\": \"<string>\",\n \"name\": \"<string>\"\n }\n ],\n \"media_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"scheduled_at\": \"2023-11-07T05:31:56Z\",\n \"network_settings\": {\n \"reddit\": {\n \"title\": \"<string>\",\n \"subreddit\": \"<string>\",\n \"flairId\": \"<string>\",\n \"destinations\": [\n {\n \"subreddit\": \"<string>\",\n \"title\": \"<string>\",\n \"flairId\": \"<string>\"\n }\n ],\n \"nsfw\": true,\n \"spoiler\": true,\n \"firstComment\": {\n \"text\": \"<string>\",\n \"delayMinutes\": 720\n }\n }\n },\n \"settings\": {},\n \"label_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"draft_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"
response = http.request(request)
puts response.read_body{
"post": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "scheduled",
"platforms": [
"<string>"
],
"text": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"text_cut": true,
"scheduled_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"source": "app",
"error": "<string>",
"accounts": [
{
"platform": "<string>",
"result": "posted",
"account_id": "<string>",
"username": "<string>",
"url": "<string>",
"error": "<string>"
}
],
"label_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
},
"success": true,
"replayed": true,
"awaiting_approval": true,
"outcome_unknown": true,
"error": "<string>"
}{
"post": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "scheduled",
"platforms": [
"<string>"
],
"text": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"text_cut": true,
"scheduled_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"source": "app",
"error": "<string>",
"accounts": [
{
"platform": "<string>",
"result": "posted",
"account_id": "<string>",
"username": "<string>",
"url": "<string>",
"error": "<string>"
}
],
"label_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
},
"success": true,
"replayed": true,
"awaiting_approval": true,
"outcome_unknown": true,
"error": "<string>"
}{
"post": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "scheduled",
"platforms": [
"<string>"
],
"text": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"text_cut": true,
"scheduled_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"source": "app",
"error": "<string>",
"accounts": [
{
"platform": "<string>",
"result": "posted",
"account_id": "<string>",
"username": "<string>",
"url": "<string>",
"error": "<string>"
}
],
"label_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
},
"success": true,
"replayed": true,
"awaiting_approval": true,
"outcome_unknown": true,
"error": "<string>"
}{
"error": "<string>",
"code": "<string>",
"field": "<string>",
"retry_after": 0
}{
"error": "<string>",
"code": "<string>",
"field": "<string>",
"retry_after": 0
}{
"error": "<string>",
"code": "<string>",
"field": "<string>",
"retry_after": 0
}{
"error": "<string>",
"code": "<string>",
"field": "<string>",
"retry_after": 0
}{
"error": "<string>",
"code": "<string>",
"field": "<string>",
"retry_after": 0
}{
"error": "<string>",
"code": "<string>",
"field": "<string>",
"retry_after": 0
}{
"error": "<string>",
"code": "<string>",
"field": "<string>",
"retry_after": 0
}{
"error": "<string>",
"code": "<string>",
"field": "<string>",
"retry_after": 0
}Authorizations
An API key from Settings, API & MCP: pm_live_...
Headers
Makes a retry safe: the same key within 24 hours answers with the first request's result. Up to 255 printable characters.
Required string length:
1 - 255Body
application/json
A post to send now or schedule.
The networks to post to.
Required array length:
1 - 12 elementsA network PostMesh posts to.
Available options:
twitter, youtube, instagram, tiktok, threads, facebook, linkedin, reddit, bluesky, mastodon, telegram, discord The caption every account gets unless captions gives it its own.
Maximum string length:
63206The connected accounts to post to, from GET /accounts. Left out, every account on the networks in platforms.
Maximum array length:
50Own captions, keyed by network ("twitter") or by account id for one account's own copy.
Show child attributes
Show child attributes
Files from POST /media, in order.
Maximum array length:
35Show child attributes
Show child attributes
Media library ids from GET /media, added after media.
Maximum array length:
35When to post. Left out, the post goes out now.
Each network's settings (privacy, title, flair...), keyed by network. The fields each takes are below.
Show child attributes
Show child attributes
One account's own settings, keyed by account id. Accounts on one network must agree.
Show child attributes
Show child attributes
Your own labels for the post.
Maximum array length:
10off sends the post without the accounts' default signatures.
Available options:
on, off How a scheduled post repeats. Needs scheduled_at.
Show child attributes
Show child attributes
The draft this post is made from. Its labels are kept when label_ids is left out.
Response
Answered from your posts: this same post was sent before under this key, so nothing was sent again.
A post: sent, scheduled, waiting or failed.
Show child attributes
Show child attributes
False when every account failed; each account's outcome is in post.accounts.
The Idempotency-Key was used before: this is that request's answer, and nothing was sent again.
The API key is in approval mode: the post waits for you in PostMesh.
PostMesh can't tell whether the post went out. Check the account before sending it again.
Was this page helpful?