> ## Documentation Index
> Fetch the complete documentation index at: https://connect.trypost.it/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Posts

> One post, many networks. Shared caption and media, optional per-network overrides.

A Connect post is one object you send to several social accounts at once. Shared caption and media, then optional tweaks per network.

You always **create a draft**. Then you schedule it or publish it now. There is no separate “publish” button on the API — changing status does that. Paths: [Create](/docs/api-reference/posts/create) and [Update](/docs/api-reference/posts/update).

Agents follow the same idea: create a draft, then publish or schedule. They cannot connect a new network.

## Life of a post

| Status              | Meaning                                     |
| ------------------- | ------------------------------------------- |
| Draft               | Editable                                    |
| Scheduled           | Goes out at the time you set                |
| Publishing          | The job is running. No event for this step. |
| Published           | Every enabled network succeeded             |
| Partially published | Some networks failed                        |
| Failed              | Every enabled network failed                |

A post that already published, is publishing, partially published, or failed cannot be edited.

Each network on the post has its own status (pending, publishing, retrying, published, failed), plus a public URL and an error after the attempt.

A time on create is just stored. The post stays a draft until you actually schedule or publish.

## Per-network caption and media

Most of the time every network gets the shared caption and files. When LinkedIn needs a longer version, or Instagram should go out without the video, you override **that** row.

| You want                              | What to do                           |
| ------------------------------------- | ------------------------------------ |
| Inherit the shared post               | Leave the override empty             |
| Different caption / files             | Set a custom caption or custom media |
| No caption / no media on that network | Send an explicit empty override      |

Length and media rules use what that network will actually receive. A long shared caption is fine if the overflowing network has a short custom one.

## Settings that only apply to one network

Some networks need extra fields before they will accept a publish: a Pinterest board, a TikTok privacy level, a Discord channel. Those live next to the caption, not inside a generic blob.

Drafts are not checked. The check runs when you schedule or publish. Full key list: [Per-platform meta](/docs/api-reference/posts/update#per-platform-meta).

## Formats

There is no live REST catalog of formats. Use the [platform pages](/docs/platforms/linkedin) or, from an agent, `list-content-types-tool`.

| Network                       | Formats                                |
| ----------------------------- | -------------------------------------- |
| LinkedIn profile              | Post (text, images, video, or one PDF) |
| LinkedIn Page                 | Page post (same media rules)           |
| X                             | Post                                   |
| Facebook                      | Post, reel, story                      |
| Instagram (either connection) | Feed, reel, story                      |
| TikTok                        | Video, photo carousel                  |
| YouTube                       | Short only                             |
| Threads                       | Post                                   |
| Pinterest                     | Pin, video pin, carousel               |
| Bluesky                       | Post                                   |
| Mastodon                      | Post                                   |
| Telegram                      | Post                                   |
| Discord                       | Channel message                        |

There is no LinkedIn carousel format and no Instagram carousel format. A LinkedIn PDF is a regular post with a document. An Instagram carousel is a feed post with several images.

## After it goes out

* [Preview](/docs/api-reference/posts/preview) shows the sanitized caption per network before you publish.
* [Metrics](/docs/api-reference/posts/metrics) pull engagement after it is live (cached a few minutes). LinkedIn **profile** posts do not support metrics.
* [Webhooks](/docs/guides/webhooks) fire on the outcome, not on “publishing.”