X (Twitter): posztolási szabályok és beállítások
Mit fogad el a X (Twitter) csatorna a Postyban: média, korlátok, kötelező mezők, és a settings objektum mezői az API-hoz.
Basics
xPost types
The same channel accepts more than one kind of post, and each kind has different requirements. The table shows what you need for each.
| Type | Media | Notes |
|---|---|---|
| Text | none | The most common. Only the text counts toward the character limit. |
| Image | up to 4 images | The four images appear in one post, as a grid. |
| Video | 1 video | You cannot attach an image with a video. |
| Thread | each part has its own | The remaining items in the value array are attached as replies to the first. |
Rules
- You write a thread as extra parts of the post: the first part is the post, the rest attach as replies below it.
- The character limit depends on the account type, so the editor shows the value unlocked for the connected account.
Settings fields
These fields go into the post's settings object, alongside the __type field. In the UI, you fill in the same ones in the channel's settings section.
| Field | Type | Required | What it does |
|---|---|---|---|
| who_can_reply_post | "everyone" | "following" | "mentionedUsers" | "subscribers" | "verified" | yes | Who can reply to the post. |
| community | string | no | The full URL of an X Community, in the form https://x.com/i/communities/<number>. Leave it empty to post to your own timeline. |
| made_with_ai | boolean | no | Marks the post as made with AI. |
| paid_partnership | boolean | no | Marks the post as a paid partnership. |
Allowed values
The fields below only accept these values. Any other value returns a 400, and the response names the field.
who_can_reply_post
| Value | Meaning |
|---|---|
| everyone | Anyone can reply. |
| following | Only people you follow. |
| mentionedUsers | Only people mentioned in the post. |
| subscribers | Only your subscribers. |
| verified | Only verified accounts. |
Examples
Each example is one item in the POST /public/v1/posts request's posts array. The envelope around it is always this:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* az alábbi elem */ ]
}Text post
{
"integration": { "id": "<x-csatorna>" },
"value": [{ "content": "<p>Ma új funkciót adtunk ki.</p>", "image": [] }],
"settings": { "__type": "x", "who_can_reply_post": "everyone" }
}Post with two images
The path values come from the media upload. An arbitrary URL from the internet will not work.
{
"integration": { "id": "<x-csatorna>" },
"value": [{
"content": "<p>Két kép egy bejegyzésben.</p>",
"image": [
{ "id": "<media-1>", "path": "https://uploads.posty.hu/egy.png" },
{ "id": "<media-2>", "path": "https://uploads.posty.hu/ketto.png" }
]
}],
"settings": { "__type": "x", "who_can_reply_post": "everyone" }
}Thread, with a two-minute delay
The first item is the post, the rest are attached as replies below it. delay is in minutes.
{
"integration": { "id": "<x-csatorna>" },
"value": [
{ "content": "<p>1/3 Kezdjük egy rövid szállal.</p>", "image": [] },
{ "content": "<p>2/3 A második rész.</p>", "image": [], "delay": 2 },
{ "content": "<p>3/3 És a zárás.</p>", "image": [], "delay": 2 }
],
"settings": { "__type": "x", "who_can_reply_post": "everyone" }
}Post to a community
The community field expects the full URL of the X community.
{
"integration": { "id": "<x-csatorna>" },
"value": [{ "content": "<p>Kérdés a közösséghez.</p>", "image": [] }],
"settings": {
"__type": "x",
"who_can_reply_post": "everyone",
"community": "https://x.com/i/communities/1493446837214187523"
}
}The channel ID comes from the channel list, and the path values for images and videos from media upload. The exact schema for the connected account comes from the settings schema endpoint. From the command line, the same thing is the --settings flag. See the CLI examples.