Tumblr
App · 20 actions
Post text, photos and links to your Tumblr blogs, reblog, edit and delete posts, and read blogs, tags, your dashboard, likes and followers.
Actions
| Action | What it does |
|---|---|
| Create a link post | Post a link, with an optional title, description and comment, to one of your blogs. |
| Create a photo post | Post an image from a web address to one of your blogs, with an optional caption. |
| Create a text post | Post text to one of your blogs: now, as a draft, privately, or scheduled in the queue. |
| Delete a post | Delete one of your posts. |
| Edit a post | Replace the text of one of your posts (and optionally its tags). |
| Follow or unfollow a blog | Make the account follow a blog, or stop following it. |
| Get a blog | Get a blog's title, description, address and how many posts and followers it has. |
| Get a post | Get one post: its text, tags, images, state and how many notes it has. |
| Get my account | Get the Tumblr account the connection uses: its username and the blogs it owns. |
| Like or unlike a post | Like a post as the account, or take the like back. |
| List a blog's followers | List the blogs that follow one of your blogs. |
| List a blog's posts | List a blog's published posts, newest first, optionally only those with a tag. |
| List a post's notes | List the likes, reblogs and replies on a post. |
| List blogs I follow | List the blogs the account follows. |
| List drafts | List the drafts saved on a blog you own. |
| List my dashboard | List the newest posts on the account's dashboard: the blogs it follows. |
| List my likes | List the posts the account has liked, most recent first. |
| List queued posts | List the posts waiting in a blog's queue, which you own. |
| Reblog a post | Reblog someone's post onto one of your blogs, with an optional comment. |
| Search posts by tag | Find public posts anywhere on Tumblr with a tag, newest first. |
Create a link post
Post a link, with an optional title, description and comment, to one of your blogs.
Inputs
- Blog
blogtextRequired - Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
- Link
urltextRequired - The web address to share, starting with https://.
- Link title
titletext - The title shown on the link. Optional.
- Link description
descriptiontext - A line about the page, shown on the link. Optional.
- Comment
commenttext - Your own words, shown above the link. Optional.
- Tags
tagslist - Tags for the post, without the #. Up to 30.
- Publish
statetext - Publish straight away (the default), save a draft, publish privately, or add to the queue, which also lets you pick when it goes live.One of:
published(Publish now (default)),draft(Save as a draft),queue(Add to the queue or schedule),private(Publish privately). Default:published. - Publish at
publish_atdate and time - When the queued post goes live. Leave empty to let the blog's queue settings decide.Only when Publish is Add to the queue or schedule.
Outputs
postobject- The post that was made
Example output
{
"post": {
"blog": "jo-bloggs",
"id": "745123456789",
"state": "published",
"url": "https://www.tumblr.com/jo-bloggs/745123456789"
}
}Create a photo post
Post an image from a web address to one of your blogs, with an optional caption.
Inputs
- Blog
blogtextRequired - Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
- Image address
image_urltextRequired - The public web address of a JPEG, PNG, GIF or WebP image, starting with https://.
- Caption
captiontext - Text shown under the image. Optional.
- Alt text
alt_texttext - A description of the image for screen readers.
- Tags
tagslist - Tags for the post, without the #. Up to 30.
- Publish
statetext - Publish straight away (the default), save a draft, publish privately, or add to the queue, which also lets you pick when it goes live.One of:
published(Publish now (default)),draft(Save as a draft),queue(Add to the queue or schedule),private(Publish privately). Default:published. - Publish at
publish_atdate and time - When the queued post goes live. Leave empty to let the blog's queue settings decide.Only when Publish is Add to the queue or schedule.
Outputs
postobject- The post that was made
Example output
{
"post": {
"blog": "jo-bloggs",
"id": "745123456789",
"state": "published",
"url": "https://www.tumblr.com/jo-bloggs/745123456789"
}
}Create a text post
Post text to one of your blogs: now, as a draft, privately, or scheduled in the queue. Blank lines start a new paragraph.
Inputs
- Blog
blogtextRequired - Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
- Text
texttextRequired - The post's text.
- Title
titletext - A heading shown above the text. Optional.
- Tags
tagslist - Tags for the post, without the #. Up to 30.
- Publish
statetext - Publish straight away (the default), save a draft, publish privately, or add to the queue, which also lets you pick when it goes live.One of:
published(Publish now (default)),draft(Save as a draft),queue(Add to the queue or schedule),private(Publish privately). Default:published. - Publish at
publish_atdate and time - When the queued post goes live. Leave empty to let the blog's queue settings decide.Only when Publish is Add to the queue or schedule.
Outputs
postobject- The post that was made
Example output
{
"post": {
"blog": "jo-bloggs",
"id": "745123456789",
"state": "published",
"url": "https://www.tumblr.com/jo-bloggs/745123456789"
}
}Delete a post
Delete one of your posts. Tumblr can't bring it back.
Inputs
- Blog
blogtextRequired - Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
- Post
posttextRequired - Pick one of the blog's newest posts, or paste a post's ID or the address copied from its page.
Outputs
blogtext- The blog it was on
deletedtrue/false- True when the post is gone
idtext- The ID of the post that was deleted
Example output
{
"blog": "jo-bloggs",
"deleted": true,
"id": "745123456789"
}Edit a post
Replace the text of one of your posts (and optionally its tags). It replaces everything in the post, images included.
Inputs
- Blog
blogtextRequired - Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
- Post
posttextRequired - Pick one of the blog's newest posts, or paste a post's ID or address.
- New text
texttextRequired - The text the post will have from now on.
- Title
titletext - A heading shown above the text. Optional.
- Tags
tagslist - The post's tags from now on. Leave empty to keep the tags it has.
Outputs
postobject- The post that was changed
Example output
{
"post": {
"blog": "jo-bloggs",
"id": "745123456789",
"url": "https://www.tumblr.com/jo-bloggs/745123456789"
}
}Follow or unfollow a blog
Make the account follow a blog, or stop following it.
Inputs
- Blog
blogtextRequired - The blog's name (such as staff), name.tumblr.com or its address.
- Change
changetext - Follow the blog or stop following it.One of:
follow,unfollow. Default:follow.
Outputs
blogtext- The blog, as name.tumblr.com
followingtrue/false- True when the account now follows it
Example output
{
"blog": "staff.tumblr.com",
"following": true
}Get a blog
Get a blog's title, description, address and how many posts and followers it has.
Inputs
- Blog
blogtextRequired - Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
Outputs
blogobject- A Tumblr blog
Example output
{
"blog": {
"description": "Notes on making things.",
"followers": 42,
"is_admin": true,
"is_nsfw": false,
"is_primary": true,
"name": "jo-bloggs",
"posts": 128,
"title": "Jo's Notes",
"updated_at": "2026-07-20T22:30:00Z",
"url": "https://jo-bloggs.tumblr.com/",
"uuid": "t:AbCdEf123"
}
}Get a post
Get one post: its text, tags, images, state and how many notes it has.
Inputs
- Blog
blogtext - The blog the post is on. Leave empty when Post is the address copied from the post's page.
- Post
posttextRequired - Pick one of the blog's newest posts, or paste a post's ID or the address copied from its page.
Outputs
postobject- A Tumblr post
Example output
{
"post": {
"blog": "jo-bloggs",
"blog_uuid": "t:AbCdEf123",
"date": "2026-07-20T22:30:00Z",
"id": "745123456789",
"image_urls": [],
"is_reblog": false,
"note_count": 3,
"reblog_key": "aBcDeFgH",
"short_url": "https://tmblr.co/ZAbc12",
"state": "published",
"summary": "Hello from a workflow",
"tags": [
"workflow"
],
"text": "Hello from a workflow",
"type": "regular",
"url": "https://www.tumblr.com/jo-bloggs/745123456789"
}
}Get my account
Get the Tumblr account the connection uses: its username and the blogs it owns.
Inputs
None.
Outputs
userobject- The connected Tumblr account
Example output
{
"user": {
"blogs": [
{
"description": "Notes on making things.",
"followers": 42,
"is_admin": true,
"is_nsfw": false,
"is_primary": true,
"name": "jo-bloggs",
"posts": 128,
"title": "Jo's Notes",
"updated_at": "2026-07-20T22:30:00Z",
"url": "https://jo-bloggs.tumblr.com/",
"uuid": "t:AbCdEf123"
}
],
"default_post_format": "html",
"following": 30,
"likes": 12,
"name": "jo-bloggs"
}
}Like or unlike a post
Like a post as the account, or take the like back.
Inputs
- Blog
blogtext - The blog the post is on. Leave empty when Post is the address copied from the post's page.
- Post
posttextRequired - Pick one of the blog's newest posts, or paste a post's ID or the address copied from its page.
- Change
changetext - Like the post or take the like back.One of:
like,unlike. Default:like.
Outputs
blogtext- The blog it is on, as name.tumblr.com
likedtrue/false- True when the account now likes it
post_idtext- The post's ID
Example output
{
"blog": "jo-bloggs.tumblr.com",
"liked": true,
"post_id": "745123456789"
}List a blog's followers
List the blogs that follow one of your blogs.
Inputs
- Blog
blogtextRequired - Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
- Limit
limitnumber - How many to return, 1 to 20.From 1 to 20. Default:
20. - Skip
offsetnumber - How many to skip, to read a later page. Use the next_offset an earlier page returned. Leave empty for the first page.At least 0.
Outputs
countnumber- How many records this page holds
followerslist- The followers
has_moretrue/false- Whether there are more to read
next_offsetnumber- The offset to ask for next, when there are more to read
total_followersnumber- How many followers in all
Example output
{
"count": 1,
"followers": [
{
"followed_at": "2026-07-01T10:00:00Z",
"name": "staff",
"url": "https://staff.tumblr.com/",
"you_follow_them": true
}
],
"has_more": false,
"next_offset": 1,
"total_followers": 1
}List a blog's posts
List a blog's published posts, newest first, optionally only those with a tag.
Inputs
- Blog
blogtextRequired - Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
- Tag
tagtext - Only posts with this tag. Leave empty for all.
- Limit
limitnumber - How many to return, 1 to 20.From 1 to 20. Default:
20. - Skip
offsetnumber - How many to skip, to read a later page. Use the next_offset an earlier page returned. Leave empty for the first page.At least 0.
Outputs
countnumber- How many records this page holds
has_moretrue/false- Whether there are more to read
next_offsetnumber- The offset to ask for next, when there are more to read
postslist- The posts
total_postsnumber- How many posts match in all
Example output
{
"count": 1,
"has_more": false,
"next_offset": 1,
"posts": [
{
"blog": "jo-bloggs",
"blog_uuid": "t:AbCdEf123",
"date": "2026-07-20T22:30:00Z",
"id": "745123456789",
"image_urls": [],
"is_reblog": false,
"note_count": 3,
"reblog_key": "aBcDeFgH",
"short_url": "https://tmblr.co/ZAbc12",
"state": "published",
"summary": "Hello from a workflow",
"tags": [
"workflow"
],
"text": "Hello from a workflow",
"type": "regular",
"url": "https://www.tumblr.com/jo-bloggs/745123456789"
}
],
"total_posts": 1
}List a post's notes
List the likes, reblogs and replies on a post.
Inputs
- Blog
blogtext - The blog the post is on. Leave empty when Post is the address copied from the post's page.
- Post
posttextRequired - Pick one of the blog's newest posts, or paste a post's ID or the address copied from its page.
- Which notes
modetext - Which kinds of note to list. Defaults to all.One of:
all(Everything (default)),likes,conversation(Replies and reblogs with comments),rollup(Reblogs, with the likes rolled up),reblogs_with_tags(Reblogs that added tags). Default:all. - Before
beforedate and time - Only notes from before this date and time. Use the next_before an earlier page returned to read on.
Outputs
countnumber- How many records this page holds
has_moretrue/false- Whether there are more to read
next_beforetext- The date and time to ask for next, or empty on the last page
noteslist- The notes
total_notesnumber- How many notes the post has
Example output
{
"count": 1,
"has_more": false,
"next_before": "",
"notes": [
{
"blog": "staff",
"blog_url": "https://staff.tumblr.com/",
"date": "2026-07-21T08:00:00Z",
"reblog_post_id": "",
"text": "",
"type": "like"
}
],
"total_notes": 1
}List blogs I follow
List the blogs the account follows.
Inputs
- Limit
limitnumber - How many to return, 1 to 20.From 1 to 20. Default:
20. - Skip
offsetnumber - How many to skip, to read a later page. Use the next_offset an earlier page returned. Leave empty for the first page.At least 0.
Outputs
blogslist- The blogs
countnumber- How many records this page holds
has_moretrue/false- Whether there are more to read
next_offsetnumber- The offset to ask for next, when there are more to read
total_blogsnumber- How many blogs the account follows
Example output
{
"blogs": [
{
"description": "Notes on making things.",
"followers": 42,
"is_admin": true,
"is_nsfw": false,
"is_primary": true,
"name": "jo-bloggs",
"posts": 128,
"title": "Jo's Notes",
"updated_at": "2026-07-20T22:30:00Z",
"url": "https://jo-bloggs.tumblr.com/",
"uuid": "t:AbCdEf123"
}
],
"count": 1,
"has_more": false,
"next_offset": 1,
"total_blogs": 1
}List drafts
List the drafts saved on a blog you own.
Inputs
- Blog
blogtextRequired - Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
- Limit
limitnumber - How many to return, 1 to 20.From 1 to 20. Default:
20. - Skip
offsetnumber - How many to skip, to read a later page. Use the next_offset an earlier page returned. Leave empty for the first page.At least 0.
Outputs
countnumber- How many records this page holds
has_moretrue/false- Whether there are more to read
next_offsetnumber- The offset to ask for next, when there are more to read
postslist- The posts
Example output
{
"count": 1,
"has_more": false,
"next_offset": 1,
"posts": [
{
"blog": "jo-bloggs",
"blog_uuid": "t:AbCdEf123",
"date": "2026-07-20T22:30:00Z",
"id": "745123456789",
"image_urls": [],
"is_reblog": false,
"note_count": 3,
"reblog_key": "aBcDeFgH",
"short_url": "https://tmblr.co/ZAbc12",
"state": "draft",
"summary": "Hello from a workflow",
"tags": [
"workflow"
],
"text": "Hello from a workflow",
"type": "regular",
"url": "https://www.tumblr.com/jo-bloggs/745123456789"
}
]
}List my dashboard
List the newest posts on the account's dashboard: the blogs it follows.
Inputs
- Limit
limitnumber - How many to return, 1 to 20.From 1 to 20. Default:
20. - Skip
offsetnumber - How many to skip, to read a later page. Use the next_offset an earlier page returned. Leave empty for the first page.At least 0.
Outputs
countnumber- How many records this page holds
has_moretrue/false- Whether there are more to read
next_offsetnumber- The offset to ask for next, when there are more to read
postslist- The posts
Example output
{
"count": 1,
"has_more": false,
"next_offset": 1,
"posts": [
{
"blog": "jo-bloggs",
"blog_uuid": "t:AbCdEf123",
"date": "2026-07-20T22:30:00Z",
"id": "745123456789",
"image_urls": [],
"is_reblog": false,
"note_count": 3,
"reblog_key": "aBcDeFgH",
"short_url": "https://tmblr.co/ZAbc12",
"state": "published",
"summary": "Hello from a workflow",
"tags": [
"workflow"
],
"text": "Hello from a workflow",
"type": "regular",
"url": "https://www.tumblr.com/jo-bloggs/745123456789"
}
]
}List my likes
List the posts the account has liked, most recent first.
Inputs
- Limit
limitnumber - How many to return, 1 to 20.From 1 to 20. Default:
20. - Skip
offsetnumber - How many to skip, to read a later page. Use the next_offset an earlier page returned. Leave empty for the first page.At least 0.
Outputs
countnumber- How many records this page holds
has_moretrue/false- Whether there are more to read
next_offsetnumber- The offset to ask for next, when there are more to read
postslist- The posts
total_likesnumber- How many posts the account liked
Example output
{
"count": 1,
"has_more": false,
"next_offset": 1,
"posts": [
{
"blog": "jo-bloggs",
"blog_uuid": "t:AbCdEf123",
"date": "2026-07-20T22:30:00Z",
"id": "745123456789",
"image_urls": [],
"is_reblog": false,
"note_count": 3,
"reblog_key": "aBcDeFgH",
"short_url": "https://tmblr.co/ZAbc12",
"state": "published",
"summary": "Hello from a workflow",
"tags": [
"workflow"
],
"text": "Hello from a workflow",
"type": "regular",
"url": "https://www.tumblr.com/jo-bloggs/745123456789"
}
],
"total_likes": 1
}List queued posts
List the posts waiting in a blog's queue, which you own.
Inputs
- Blog
blogtextRequired - Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
- Limit
limitnumber - How many to return, 1 to 20.From 1 to 20. Default:
20. - Skip
offsetnumber - How many to skip, to read a later page. Use the next_offset an earlier page returned. Leave empty for the first page.At least 0.
Outputs
countnumber- How many records this page holds
has_moretrue/false- Whether there are more to read
next_offsetnumber- The offset to ask for next, when there are more to read
postslist- The posts
Example output
{
"count": 1,
"has_more": false,
"next_offset": 1,
"posts": [
{
"blog": "jo-bloggs",
"blog_uuid": "t:AbCdEf123",
"date": "2026-07-20T22:30:00Z",
"id": "745123456789",
"image_urls": [],
"is_reblog": false,
"note_count": 3,
"reblog_key": "aBcDeFgH",
"short_url": "https://tmblr.co/ZAbc12",
"state": "queued",
"summary": "Hello from a workflow",
"tags": [
"workflow"
],
"text": "Hello from a workflow",
"type": "regular",
"url": "https://www.tumblr.com/jo-bloggs/745123456789"
}
]
}Reblog a post
Reblog someone's post onto one of your blogs, with an optional comment.
Inputs
- Reblog to
blogtextRequired - Which of your blogs gets the reblog.
- Post's blog
parent_blogtext - The blog the post is on. Leave empty when Post is an address copied from Tumblr.
- Post
posttextRequired - The post's ID, or the address copied from its page on Tumblr (with an address, no blog is needed).
- Comment
commenttext - Your own words added to the reblog. Optional.
- Tags
tagslist - Tags for the post, without the #. Up to 30.
- Publish
statetext - Publish straight away (the default), save a draft, publish privately, or add to the queue, which also lets you pick when it goes live.One of:
published(Publish now (default)),draft(Save as a draft),queue(Add to the queue or schedule),private(Publish privately). Default:published. - Publish at
publish_atdate and time - When the queued post goes live. Leave empty to let the blog's queue settings decide.Only when Publish is Add to the queue or schedule.
Outputs
postobject- The post that was made
Example output
{
"post": {
"blog": "jo-bloggs",
"id": "745123456789",
"state": "published",
"url": "https://www.tumblr.com/jo-bloggs/745123456789"
}
}Search posts by tag
Find public posts anywhere on Tumblr with a tag, newest first.
Inputs
- Tag
tagtextRequired - The tag to look for, without the #.
- Posted before
beforedate and time - Only posts from before this date and time. Use the next_before an earlier page returned to read on.
- Limit
limitnumber - How many to return, 1 to 20.From 1 to 20. Default:
20.
Outputs
countnumber- How many records this page holds
has_moretrue/false- Whether there are more to read
next_beforetext- The date and time to ask for next, or empty on the last page
postslist- The posts
Example output
{
"count": 1,
"has_more": false,
"next_before": "",
"posts": [
{
"blog": "jo-bloggs",
"blog_uuid": "t:AbCdEf123",
"date": "2026-07-20T22:30:00Z",
"id": "745123456789",
"image_urls": [],
"is_reblog": false,
"note_count": 3,
"reblog_key": "aBcDeFgH",
"short_url": "https://tmblr.co/ZAbc12",
"state": "published",
"summary": "Hello from a workflow",
"tags": [
"workflow"
],
"text": "Hello from a workflow",
"type": "regular",
"url": "https://www.tumblr.com/jo-bloggs/745123456789"
}
]
}