Platforms
Tumblr: posting rules and settings
What a Tumblr channel accepts in Postemi: media, limits, required fields, and the fields of the settings object for the API.
Beta
New in Postemi and not yet tested with many accounts. Tell us if something does not work.
Basics
Platform
Tumblr
Character limit
The platform does not specify a general limit.
Media
Up to 10 photos, or one video.
settings.__type
tumblrRequired fields
No required settings fields.
Platform page
Rules
- You pick the blog when you connect. Each blog is its own channel.
- Long text is split into blocks of 4096 characters.
- Beta: not yet tested with many accounts.
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 |
|---|---|---|---|
| title | string | no | A heading at the top of the post, up to 4096 characters. Leave it out for no heading (an empty string is refused). |
| link | string | no | A link block added below the text. |
| sourceUrl | string | no | The source of the post. |
| tags | string | no | Tags separated with commas, up to 4096 characters in total. |
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": [ /* the item below */ ]
}{
"integration": { "id": "<channel-id>" },
"value": [{ "content": "<p>The text of the post.</p>", "image": [] }],
"settings": { "__type": "tumblr" }
}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.
Is something missing from this page? Email [email protected] or use the form on the Help page.