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

ActionWhat it does
Create a link postPost a link, with an optional title, description and comment, to one of your blogs.
Create a photo postPost an image from a web address to one of your blogs, with an optional caption.
Create a text postPost text to one of your blogs: now, as a draft, privately, or scheduled in the queue.
Delete a postDelete one of your posts.
Edit a postReplace the text of one of your posts (and optionally its tags).
Follow or unfollow a blogMake the account follow a blog, or stop following it.
Get a blogGet a blog's title, description, address and how many posts and followers it has.
Get a postGet one post: its text, tags, images, state and how many notes it has.
Get my accountGet the Tumblr account the connection uses: its username and the blogs it owns.
Like or unlike a postLike a post as the account, or take the like back.
List a blog's followersList the blogs that follow one of your blogs.
List a blog's postsList a blog's published posts, newest first, optionally only those with a tag.
List a post's notesList the likes, reblogs and replies on a post.
List blogs I followList the blogs the account follows.
List draftsList the drafts saved on a blog you own.
List my dashboardList the newest posts on the account's dashboard: the blogs it follows.
List my likesList the posts the account has liked, most recent first.
List queued postsList the posts waiting in a blog's queue, which you own.
Reblog a postReblog someone's post onto one of your blogs, with an optional comment.
Search posts by tagFind 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

BlogblogtextRequired
Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
LinkurltextRequired
The web address to share, starting with https://.
Link titletitletext
The title shown on the link. Optional.
Link descriptiondescriptiontext
A line about the page, shown on the link. Optional.
Commentcommenttext
Your own words, shown above the link. Optional.
Tagstagslist
Tags for the post, without the #. Up to 30.
Publishstatetext
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 atpublish_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

BlogblogtextRequired
Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
Image addressimage_urltextRequired
The public web address of a JPEG, PNG, GIF or WebP image, starting with https://.
Captioncaptiontext
Text shown under the image. Optional.
Alt textalt_texttext
A description of the image for screen readers.
Tagstagslist
Tags for the post, without the #. Up to 30.
Publishstatetext
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 atpublish_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

BlogblogtextRequired
Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
TexttexttextRequired
The post's text.
Titletitletext
A heading shown above the text. Optional.
Tagstagslist
Tags for the post, without the #. Up to 30.
Publishstatetext
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 atpublish_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

BlogblogtextRequired
Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
PostposttextRequired
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

BlogblogtextRequired
Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
PostposttextRequired
Pick one of the blog's newest posts, or paste a post's ID or address.
New texttexttextRequired
The text the post will have from now on.
Titletitletext
A heading shown above the text. Optional.
Tagstagslist
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

BlogblogtextRequired
The blog's name (such as staff), name.tumblr.com or its address.
Changechangetext
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

BlogblogtextRequired
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

Blogblogtext
The blog the post is on. Leave empty when Post is the address copied from the post's page.
PostposttextRequired
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

Blogblogtext
The blog the post is on. Leave empty when Post is the address copied from the post's page.
PostposttextRequired
Pick one of the blog's newest posts, or paste a post's ID or the address copied from its page.
Changechangetext
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

BlogblogtextRequired
Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
Limitlimitnumber
How many to return, 1 to 20.From 1 to 20. Default: 20.
Skipoffsetnumber
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

BlogblogtextRequired
Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
Tagtagtext
Only posts with this tag. Leave empty for all.
Limitlimitnumber
How many to return, 1 to 20.From 1 to 20. Default: 20.
Skipoffsetnumber
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

Blogblogtext
The blog the post is on. Leave empty when Post is the address copied from the post's page.
PostposttextRequired
Pick one of the blog's newest posts, or paste a post's ID or the address copied from its page.
Which notesmodetext
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.
Beforebeforedate 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

Limitlimitnumber
How many to return, 1 to 20.From 1 to 20. Default: 20.
Skipoffsetnumber
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

BlogblogtextRequired
Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
Limitlimitnumber
How many to return, 1 to 20.From 1 to 20. Default: 20.
Skipoffsetnumber
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

Limitlimitnumber
How many to return, 1 to 20.From 1 to 20. Default: 20.
Skipoffsetnumber
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

Limitlimitnumber
How many to return, 1 to 20.From 1 to 20. Default: 20.
Skipoffsetnumber
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

BlogblogtextRequired
Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
Limitlimitnumber
How many to return, 1 to 20.From 1 to 20. Default: 20.
Skipoffsetnumber
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 toblogtextRequired
Which of your blogs gets the reblog.
Post's blogparent_blogtext
The blog the post is on. Leave empty when Post is an address copied from Tumblr.
PostposttextRequired
The post's ID, or the address copied from its page on Tumblr (with an address, no blog is needed).
Commentcommenttext
Your own words added to the reblog. Optional.
Tagstagslist
Tags for the post, without the #. Up to 30.
Publishstatetext
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 atpublish_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

TagtagtextRequired
The tag to look for, without the #.
Posted beforebeforedate and time
Only posts from before this date and time. Use the next_before an earlier page returned to read on.
Limitlimitnumber
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"
    }
  ]
}

On this page