# Tumblr

> Post text, photos and links to your Tumblr blogs, reblog, edit and delete posts, and read blogs, tags, your dashboard, likes and followers.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/tumblr

## Actions

### Create a link post

Post a link, with an optional title, description and comment, to one of your blogs.

**Inputs**

- Blog (`blog`, text, required): Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
- Link (`url`, text, required): The web address to share, starting with https://.
- Link title (`title`, text): The title shown on the link. Optional.
- Link description (`description`, text): A line about the page, shown on the link. Optional.
- Comment (`comment`, text): Your own words, shown above the link. Optional.
- Tags (`tags`, list): Tags for the post, without the #. Up to 30.
- Publish (`state`, text): 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_at`, date 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**

- `post` (object): The post that was made

**Example output**

```json
{
  "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 (`blog`, text, required): Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
- Image address (`image_url`, text, required): The public web address of a JPEG, PNG, GIF or WebP image, starting with https://.
- Caption (`caption`, text): Text shown under the image. Optional.
- Alt text (`alt_text`, text): A description of the image for screen readers.
- Tags (`tags`, list): Tags for the post, without the #. Up to 30.
- Publish (`state`, text): 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_at`, date 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**

- `post` (object): The post that was made

**Example output**

```json
{
  "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 (`blog`, text, required): Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
- Text (`text`, text, required): The post's text.
- Title (`title`, text): A heading shown above the text. Optional.
- Tags (`tags`, list): Tags for the post, without the #. Up to 30.
- Publish (`state`, text): 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_at`, date 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**

- `post` (object): The post that was made

**Example output**

```json
{
  "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 (`blog`, text, required): Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
- Post (`post`, text, required): Pick one of the blog's newest posts, or paste a post's ID or the address copied from its page.

**Outputs**

- `blog` (text): The blog it was on
- `deleted` (true/false): True when the post is gone
- `id` (text): The ID of the post that was deleted

**Example output**

```json
{
  "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 (`blog`, text, required): Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
- Post (`post`, text, required): Pick one of the blog's newest posts, or paste a post's ID or address.
- New text (`text`, text, required): The text the post will have from now on.
- Title (`title`, text): A heading shown above the text. Optional.
- Tags (`tags`, list): The post's tags from now on. Leave empty to keep the tags it has.

**Outputs**

- `post` (object): The post that was changed

**Example output**

```json
{
  "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 (`blog`, text, required): The blog's name (such as staff), name.tumblr.com or its address.
- Change (`change`, text): Follow the blog or stop following it. One of: `follow`, `unfollow`. Default: `follow`.

**Outputs**

- `blog` (text): The blog, as name.tumblr.com
- `following` (true/false): True when the account now follows it

**Example output**

```json
{
  "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 (`blog`, text, required): Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.

**Outputs**

- `blog` (object): A Tumblr blog

**Example output**

```json
{
  "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 (`blog`, text): The blog the post is on. Leave empty when Post is the address copied from the post's page.
- Post (`post`, text, required): Pick one of the blog's newest posts, or paste a post's ID or the address copied from its page.

**Outputs**

- `post` (object): A Tumblr post

**Example output**

```json
{
  "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**

- `user` (object): The connected Tumblr account

**Example output**

```json
{
  "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 (`blog`, text): The blog the post is on. Leave empty when Post is the address copied from the post's page.
- Post (`post`, text, required): Pick one of the blog's newest posts, or paste a post's ID or the address copied from its page.
- Change (`change`, text): Like the post or take the like back. One of: `like`, `unlike`. Default: `like`.

**Outputs**

- `blog` (text): The blog it is on, as name.tumblr.com
- `liked` (true/false): True when the account now likes it
- `post_id` (text): The post's ID

**Example output**

```json
{
  "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 (`blog`, text, required): Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
- Limit (`limit`, number): How many to return, 1 to 20. From 1 to 20. Default: `20`.
- Skip (`offset`, number): 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**

- `count` (number): How many records this page holds
- `followers` (list): The followers
- `has_more` (true/false): Whether there are more to read
- `next_offset` (number): The offset to ask for next, when there are more to read
- `total_followers` (number): How many followers in all

**Example output**

```json
{
  "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 (`blog`, text, required): Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
- Tag (`tag`, text): Only posts with this tag. Leave empty for all.
- Limit (`limit`, number): How many to return, 1 to 20. From 1 to 20. Default: `20`.
- Skip (`offset`, number): 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**

- `count` (number): How many records this page holds
- `has_more` (true/false): Whether there are more to read
- `next_offset` (number): The offset to ask for next, when there are more to read
- `posts` (list): The posts
- `total_posts` (number): How many posts match in all

**Example output**

```json
{
  "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 (`blog`, text): The blog the post is on. Leave empty when Post is the address copied from the post's page.
- Post (`post`, text, required): Pick one of the blog's newest posts, or paste a post's ID or the address copied from its page.
- Which notes (`mode`, text): 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 (`before`, date and time): Only notes from before this date and time. Use the next_before an earlier page returned to read on.

**Outputs**

- `count` (number): How many records this page holds
- `has_more` (true/false): Whether there are more to read
- `next_before` (text): The date and time to ask for next, or empty on the last page
- `notes` (list): The notes
- `total_notes` (number): How many notes the post has

**Example output**

```json
{
  "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 (`limit`, number): How many to return, 1 to 20. From 1 to 20. Default: `20`.
- Skip (`offset`, number): 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**

- `blogs` (list): The blogs
- `count` (number): How many records this page holds
- `has_more` (true/false): Whether there are more to read
- `next_offset` (number): The offset to ask for next, when there are more to read
- `total_blogs` (number): How many blogs the account follows

**Example output**

```json
{
  "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 (`blog`, text, required): Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
- Limit (`limit`, number): How many to return, 1 to 20. From 1 to 20. Default: `20`.
- Skip (`offset`, number): 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**

- `count` (number): How many records this page holds
- `has_more` (true/false): Whether there are more to read
- `next_offset` (number): The offset to ask for next, when there are more to read
- `posts` (list): The posts

**Example output**

```json
{
  "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 (`limit`, number): How many to return, 1 to 20. From 1 to 20. Default: `20`.
- Skip (`offset`, number): 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**

- `count` (number): How many records this page holds
- `has_more` (true/false): Whether there are more to read
- `next_offset` (number): The offset to ask for next, when there are more to read
- `posts` (list): The posts

**Example output**

```json
{
  "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 (`limit`, number): How many to return, 1 to 20. From 1 to 20. Default: `20`.
- Skip (`offset`, number): 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**

- `count` (number): How many records this page holds
- `has_more` (true/false): Whether there are more to read
- `next_offset` (number): The offset to ask for next, when there are more to read
- `posts` (list): The posts
- `total_likes` (number): How many posts the account liked

**Example output**

```json
{
  "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 (`blog`, text, required): Pick one of your blogs, or type a blog's name (such as myblog), name.tumblr.com or its address.
- Limit (`limit`, number): How many to return, 1 to 20. From 1 to 20. Default: `20`.
- Skip (`offset`, number): 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**

- `count` (number): How many records this page holds
- `has_more` (true/false): Whether there are more to read
- `next_offset` (number): The offset to ask for next, when there are more to read
- `posts` (list): The posts

**Example output**

```json
{
  "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 (`blog`, text, required): Which of your blogs gets the reblog.
- Post's blog (`parent_blog`, text): The blog the post is on. Leave empty when Post is an address copied from Tumblr.
- Post (`post`, text, required): The post's ID, or the address copied from its page on Tumblr (with an address, no blog is needed).
- Comment (`comment`, text): Your own words added to the reblog. Optional.
- Tags (`tags`, list): Tags for the post, without the #. Up to 30.
- Publish (`state`, text): 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_at`, date 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**

- `post` (object): The post that was made

**Example output**

```json
{
  "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 (`tag`, text, required): The tag to look for, without the #.
- Posted before (`before`, date and time): Only posts from before this date and time. Use the next_before an earlier page returned to read on.
- Limit (`limit`, number): How many to return, 1 to 20. From 1 to 20. Default: `20`.

**Outputs**

- `count` (number): How many records this page holds
- `has_more` (true/false): Whether there are more to read
- `next_before` (text): The date and time to ask for next, or empty on the last page
- `posts` (list): The posts

**Example output**

```json
{
  "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"
    }
  ]
}
```
