Create post

curl --request POST \
  --url https://app.trypost.it/api/posts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "We just shipped scheduled threads. Here is how they work.",
  "status": "scheduled",
  "scheduled_at": "2026-10-12T14:00:00Z",
  "media": [
    {
      "url": "https://example.com/launch.jpg",
      "alt": "Product launch banner"
    }
  ],
  "platforms": [
    {
      "social_account_id": "9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54",
      "content_type": "x_post",
      "meta": {
        "thread_replies": [
          {
            "text": "2/ Replies publish under the first post."
          }
        ]
      }
    }
  ],
  "label_ids": [
    "9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f"
  ]
}
'

import requests

url = "https://app.trypost.it/api/posts"

payload = {
    "content": "We just shipped scheduled threads. Here is how they work.",
    "status": "scheduled",
    "scheduled_at": "2026-10-12T14:00:00Z",
    "media": [
        {
            "url": "https://example.com/launch.jpg",
            "alt": "Product launch banner"
        }
    ],
    "platforms": [
        {
            "social_account_id": "9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54",
            "content_type": "x_post",
            "meta": { "thread_replies": [{ "text": "2/ Replies publish under the first post." }] }
        }
    ],
    "label_ids": ["9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f"]
}
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({
    content: 'We just shipped scheduled threads. Here is how they work.',
    status: 'scheduled',
    scheduled_at: '2026-10-12T14:00:00Z',
    media: [{url: 'https://example.com/launch.jpg', alt: 'Product launch banner'}],
    platforms: [
      {
        social_account_id: '9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54',
        content_type: 'x_post',
        meta: {thread_replies: [{text: '2/ Replies publish under the first post.'}]}
      }
    ],
    label_ids: ['9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f']
  })
};

fetch('https://app.trypost.it/api/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://app.trypost.it/api/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([
    'content' => 'We just shipped scheduled threads. Here is how they work.',
    'status' => 'scheduled',
    'scheduled_at' => '2026-10-12T14:00:00Z',
    'media' => [
        [
                'url' => 'https://example.com/launch.jpg',
                'alt' => 'Product launch banner'
        ]
    ],
    'platforms' => [
        [
                'social_account_id' => '9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54',
                'content_type' => 'x_post',
                'meta' => [
                                'thread_replies' => [
                                                                [
                                                                                                                                'text' => '2/ Replies publish under the first post.'
                                                                ]
                                ]
                ]
        ]
    ],
    'label_ids' => [
        '9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f'
    ]
  ]),
  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://app.trypost.it/api/posts"

	payload := strings.NewReader("{\n  \"content\": \"We just shipped scheduled threads. Here is how they work.\",\n  \"status\": \"scheduled\",\n  \"scheduled_at\": \"2026-10-12T14:00:00Z\",\n  \"media\": [\n    {\n      \"url\": \"https://example.com/launch.jpg\",\n      \"alt\": \"Product launch banner\"\n    }\n  ],\n  \"platforms\": [\n    {\n      \"social_account_id\": \"9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54\",\n      \"content_type\": \"x_post\",\n      \"meta\": {\n        \"thread_replies\": [\n          {\n            \"text\": \"2/ Replies publish under the first post.\"\n          }\n        ]\n      }\n    }\n  ],\n  \"label_ids\": [\n    \"9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f\"\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://app.trypost.it/api/posts")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"content\": \"We just shipped scheduled threads. Here is how they work.\",\n  \"status\": \"scheduled\",\n  \"scheduled_at\": \"2026-10-12T14:00:00Z\",\n  \"media\": [\n    {\n      \"url\": \"https://example.com/launch.jpg\",\n      \"alt\": \"Product launch banner\"\n    }\n  ],\n  \"platforms\": [\n    {\n      \"social_account_id\": \"9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54\",\n      \"content_type\": \"x_post\",\n      \"meta\": {\n        \"thread_replies\": [\n          {\n            \"text\": \"2/ Replies publish under the first post.\"\n          }\n        ]\n      }\n    }\n  ],\n  \"label_ids\": [\n    \"9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.trypost.it/api/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  \"content\": \"We just shipped scheduled threads. Here is how they work.\",\n  \"status\": \"scheduled\",\n  \"scheduled_at\": \"2026-10-12T14:00:00Z\",\n  \"media\": [\n    {\n      \"url\": \"https://example.com/launch.jpg\",\n      \"alt\": \"Product launch banner\"\n    }\n  ],\n  \"platforms\": [\n    {\n      \"social_account_id\": \"9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54\",\n      \"content_type\": \"x_post\",\n      \"meta\": {\n        \"thread_replies\": [\n          {\n            \"text\": \"2/ Replies publish under the first post.\"\n          }\n        ]\n      }\n    }\n  ],\n  \"label_ids\": [\n    \"9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "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": "We just shipped scheduled threads. Here is how they work.",
  "media": [
    {
      "id": "9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
      "path": "medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
      "url": "https://media.trypost.it/medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
      "type": "image",
      "mime_type": "image/jpeg",
      "original_filename": "launch.jpg",
      "size": 482113,
      "meta": {
        "width": 1080,
        "height": 1350,
        "alt_text": "Product launch banner"
      }
    }
  ],
  "status": "scheduled",
  "schedule_mode": "custom",
  "scheduled_at": "2026-10-12 14: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-5a6b7c8d9e10",
      "platform": "x",
      "content_type": "x_post",
      "meta": {
        "thread_replies": [
          {
            "text": "2/ Replies publish under the first post.",
            "media": []
          }
        ]
      },
      "status": "pending",
      "enabled": true,
      "platform_url": null,
      "published_at": null,
      "error_message": null,
      "display_name": "TryPost",
      "display_username": "trypostit",
      "display_avatar": "https://pbs.twimg.com/profile_images/1790000000000000000/avatar_400x400.jpg",
      "social_account": {
        "id": "9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54",
        "platform": "x",
        "display_name": "TryPost",
        "username": "trypostit",
        "status": "connected",
        "has_posting_schedule": true,
        "timezone": "America/Sao_Paulo",
        "posting_goal": 5,
        "max_content_length": 280,
        "long_posts": false,
        "verified_badge": null
      }
    }
  ],
  "labels": [
    {
      "id": "9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f",
      "name": "Launch",
      "color": "#2563EB",
      "created_at": "2026-09-01 10:00:00",
      "updated_at": "2026-09-01 10:00:00"
    }
  ],
  "created_at": "2026-10-08 13:20:11",
  "updated_at": "2026-10-08 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

Create post

Creates one post on one social account.

status: draft (default) saves a draft.
status: scheduled with scheduled_at schedules it at that time; with queue (next or top) it takes a slot of the channel’s posting schedule; with queue_slot it takes that exact free slot (from GET /channels/{account}/queue/slots).
status: publishing publishes it now.

Omitted content_type is chosen like the app does: on Pinterest a video makes pinterest_video_pin and several images pinterest_carousel, on TikTok images only make tiktok_photo, every other network takes its default format.

To schedule or publish, the destination needs its required settings in platforms[].meta (see PlatformMeta). API keys belong to workspace admins, who publish directly, so a post created through the API is never stored as pending_approval.

To post the same text on several channels at once, use POST /posts/batch.

POST

posts

Create post

curl --request POST \
  --url https://app.trypost.it/api/posts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "We just shipped scheduled threads. Here is how they work.",
  "status": "scheduled",
  "scheduled_at": "2026-10-12T14:00:00Z",
  "media": [
    {
      "url": "https://example.com/launch.jpg",
      "alt": "Product launch banner"
    }
  ],
  "platforms": [
    {
      "social_account_id": "9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54",
      "content_type": "x_post",
      "meta": {
        "thread_replies": [
          {
            "text": "2/ Replies publish under the first post."
          }
        ]
      }
    }
  ],
  "label_ids": [
    "9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f"
  ]
}
'

import requests

url = "https://app.trypost.it/api/posts"

payload = {
    "content": "We just shipped scheduled threads. Here is how they work.",
    "status": "scheduled",
    "scheduled_at": "2026-10-12T14:00:00Z",
    "media": [
        {
            "url": "https://example.com/launch.jpg",
            "alt": "Product launch banner"
        }
    ],
    "platforms": [
        {
            "social_account_id": "9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54",
            "content_type": "x_post",
            "meta": { "thread_replies": [{ "text": "2/ Replies publish under the first post." }] }
        }
    ],
    "label_ids": ["9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f"]
}
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({
    content: 'We just shipped scheduled threads. Here is how they work.',
    status: 'scheduled',
    scheduled_at: '2026-10-12T14:00:00Z',
    media: [{url: 'https://example.com/launch.jpg', alt: 'Product launch banner'}],
    platforms: [
      {
        social_account_id: '9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54',
        content_type: 'x_post',
        meta: {thread_replies: [{text: '2/ Replies publish under the first post.'}]}
      }
    ],
    label_ids: ['9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f']
  })
};

fetch('https://app.trypost.it/api/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://app.trypost.it/api/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([
    'content' => 'We just shipped scheduled threads. Here is how they work.',
    'status' => 'scheduled',
    'scheduled_at' => '2026-10-12T14:00:00Z',
    'media' => [
        [
                'url' => 'https://example.com/launch.jpg',
                'alt' => 'Product launch banner'
        ]
    ],
    'platforms' => [
        [
                'social_account_id' => '9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54',
                'content_type' => 'x_post',
                'meta' => [
                                'thread_replies' => [
                                                                [
                                                                                                                                'text' => '2/ Replies publish under the first post.'
                                                                ]
                                ]
                ]
        ]
    ],
    'label_ids' => [
        '9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f'
    ]
  ]),
  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://app.trypost.it/api/posts"

	payload := strings.NewReader("{\n  \"content\": \"We just shipped scheduled threads. Here is how they work.\",\n  \"status\": \"scheduled\",\n  \"scheduled_at\": \"2026-10-12T14:00:00Z\",\n  \"media\": [\n    {\n      \"url\": \"https://example.com/launch.jpg\",\n      \"alt\": \"Product launch banner\"\n    }\n  ],\n  \"platforms\": [\n    {\n      \"social_account_id\": \"9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54\",\n      \"content_type\": \"x_post\",\n      \"meta\": {\n        \"thread_replies\": [\n          {\n            \"text\": \"2/ Replies publish under the first post.\"\n          }\n        ]\n      }\n    }\n  ],\n  \"label_ids\": [\n    \"9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f\"\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://app.trypost.it/api/posts")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"content\": \"We just shipped scheduled threads. Here is how they work.\",\n  \"status\": \"scheduled\",\n  \"scheduled_at\": \"2026-10-12T14:00:00Z\",\n  \"media\": [\n    {\n      \"url\": \"https://example.com/launch.jpg\",\n      \"alt\": \"Product launch banner\"\n    }\n  ],\n  \"platforms\": [\n    {\n      \"social_account_id\": \"9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54\",\n      \"content_type\": \"x_post\",\n      \"meta\": {\n        \"thread_replies\": [\n          {\n            \"text\": \"2/ Replies publish under the first post.\"\n          }\n        ]\n      }\n    }\n  ],\n  \"label_ids\": [\n    \"9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.trypost.it/api/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  \"content\": \"We just shipped scheduled threads. Here is how they work.\",\n  \"status\": \"scheduled\",\n  \"scheduled_at\": \"2026-10-12T14:00:00Z\",\n  \"media\": [\n    {\n      \"url\": \"https://example.com/launch.jpg\",\n      \"alt\": \"Product launch banner\"\n    }\n  ],\n  \"platforms\": [\n    {\n      \"social_account_id\": \"9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54\",\n      \"content_type\": \"x_post\",\n      \"meta\": {\n        \"thread_replies\": [\n          {\n            \"text\": \"2/ Replies publish under the first post.\"\n          }\n        ]\n      }\n    }\n  ],\n  \"label_ids\": [\n    \"9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "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": "We just shipped scheduled threads. Here is how they work.",
  "media": [
    {
      "id": "9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
      "path": "medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
      "url": "https://media.trypost.it/medias/9d3c1f30-8a9b-4c0d-9e1f-2a3b4c5d6e7f.jpg",
      "type": "image",
      "mime_type": "image/jpeg",
      "original_filename": "launch.jpg",
      "size": 482113,
      "meta": {
        "width": 1080,
        "height": 1350,
        "alt_text": "Product launch banner"
      }
    }
  ],
  "status": "scheduled",
  "schedule_mode": "custom",
  "scheduled_at": "2026-10-12 14: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-5a6b7c8d9e10",
      "platform": "x",
      "content_type": "x_post",
      "meta": {
        "thread_replies": [
          {
            "text": "2/ Replies publish under the first post.",
            "media": []
          }
        ]
      },
      "status": "pending",
      "enabled": true,
      "platform_url": null,
      "published_at": null,
      "error_message": null,
      "display_name": "TryPost",
      "display_username": "trypostit",
      "display_avatar": "https://pbs.twimg.com/profile_images/1790000000000000000/avatar_400x400.jpg",
      "social_account": {
        "id": "9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54",
        "platform": "x",
        "display_name": "TryPost",
        "username": "trypostit",
        "status": "connected",
        "has_posting_schedule": true,
        "timezone": "America/Sao_Paulo",
        "posting_goal": 5,
        "max_content_length": 280,
        "long_posts": false,
        "verified_badge": null
      }
    }
  ],
  "labels": [
    {
      "id": "9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f",
      "name": "Launch",
      "color": "#2563EB",
      "created_at": "2026-09-01 10:00:00",
      "updated_at": "2026-09-01 10:00:00"
    }
  ],
  "created_at": "2026-10-08 13:20:11",
  "updated_at": "2026-10-08 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

Authorization

string

header

required

Workspace API key from Settings → API Keys.

Body

application/json

platforms

object[]

required

Exactly one destination.

Required array length: 1 element

Show child attributes

content

string | null

Post text, at most 25000 characters. When status is scheduled or publishing it must also fit each account's limit (max_content_length of the social account, for example 280 on X or 25000 for X accounts with long posts, 300 on Bluesky, 500 on Mastodon including the content warning), measured on the text the network receives. A scheduled or published post needs text or media.

Maximum string length: 25000

media

object[]

Media in order. Each item is one of upload_token, url or id. Types the channel does not accept are refused.

Show child attributes

status

enum<string>

default:draft

draft keeps the post editable. scheduled schedules it at scheduled_at or in the channel queue (queue). publishing publishes it now.

Available options:

draft,

scheduled,

publishing

scheduled_at

string<date-time> | null

When to publish, for status: scheduled. Any date string; must be in the future and before 2038-01-19. Cannot be combined with queue. Required with status: scheduled unless queue or queue_slot is sent.

queue

enum<string> | null

Queue position, only with status: scheduled. next takes the channel's first free slot; top takes its first slot and moves the queued posts behind it to the next gap. The channel must have posting times (has_posting_schedule). Cannot be combined with scheduled_at.

Available options:

next,

top,

null

queue_slot

string<date-time> | null

Instant of one free slot from GET /channels/{account}/queue/slots, only with status: scheduled. Stores the post as a queue post in that slot; refused when the slot is taken or held by a pending approval request. Before 2038-01-19. Cannot be combined with queue. Takes the place of scheduled_at when both are sent.

label_ids

string<uuid>[]

Labels of this workspace.

Response

The created post.

A post on one channel. Posts created together from several channels are independent posts that share a post_group_id.

string<uuid>

post_group_id

string<uuid> | null

Shared by the posts created in one batch.

author

object | null

A workspace member. Only the id and name are exposed.

Show child attributes

content

string | null

Post text, stored as sent (posts written in the app hold the editor's HTML).

media

object[] | null

Show child attributes

status

enum<string>

pending_approval is a post a member who needs approval asked to schedule or publish.

Available options:

draft,

pending_approval,

scheduled,

publishing,

published,

partially_published,

failed

schedule_mode

enum<string> | null

queue: the post holds a slot of the channel's posting schedule. custom: it is scheduled at its own time.

Available options:

queue,

custom,

null

scheduled_at

string | null

UTC, format Y-m-d H:i:s.

published_at

string | null

UTC, format Y-m-d H:i:s.

approval_requested_by

object | null

Who asked for approval (not always the author).

Show child attributes

approval_requested_at

string | null

UTC, format Y-m-d H:i:s.

approved_by

object | null

A workspace member. Only the id and name are exposed.

Show child attributes

approved_at

string | null

UTC, format Y-m-d H:i:s.

recurrence

object | null

Repeat rule, or null.

Show child attributes

origin

enum<string>

network for posts imported from the network (published outside TryPost).

Available options:

trypost,

network

platforms

object[]

Show child attributes

labels

object[]

Show child attributes

created_at

string

UTC, format Y-m-d H:i:s.

updated_at

string

UTC, format Y-m-d H:i:s.

Overview

Posts

Post notes

Approvals

Recurrence

Media and uploads

Social accounts

Channels

Ideas

Idea stages

Analytics

Labels

Signatures

Workspace

API keys

Webhooks

Repurposes

Platform

Create post

Authorizations

Body

Response