Mastodon

Post to Mastodon from a workflow, on any server including your own. Publish posts and polls, read timelines, threads and notifications, favourite, boost and bookmark, search the instance, and follow accounts.

Actions

Action	What it does
Bookmark post	Bookmark a post for this account.
Boost post	Boost a post to this account's followers.
Delete post	Delete one of this account's own posts.
Favourite post	Favourite a post.
Follow account	Follow an account.
Get a post's thread	Read the thread around a post: the posts it replies to, and every reply below it.
Get hashtag timeline	Read the public posts carrying a hashtag, optionally narrowed by other tags.
Get home timeline	Read this account's own home timeline - the posts from the accounts and hashtags it follows, newest first.
Get instance	Read what the connected server is and what it allows: its title, version, languages, rules and its limits - including 'configuration.statuses.max_characters', the longest post it accepts, which differs from server to server.
Get my account	Read the account this connection acts as: its handle, ID, display name, counts and its own posting defaults.
Get post	Read one post in full: who wrote it, its text, its counts, its attachments and whether this account has favourited, boosted or bookmarked it.
Get public timeline	Read the instance's public timeline.
List an account's posts	Read the posts one account has published, newest first, optionally only the pinned ones, only those with media, or only those carrying a hashtag.
List notifications	Read this account's notifications - mentions, boosts, favourites, new followers and the rest - newest first, optionally narrowed to the kinds you care about.
Look up account	Find an account by handle and get its ID, which the other account actions take.
Publish a post	Publish a post, optionally as a reply, with a content warning, with a poll, or scheduled for later.
Remove boost	Undo a boost.
Remove favourite	Take back a favourite on a post.
Search	Search this instance for accounts, hashtags and posts.
Unfollow account	Stop following an account, or withdraw a follow request that is still waiting for approval.

Bookmark post

Bookmark a post for this account. Bookmarks are private - nobody else is told - and, unlike favourites, they are not sent to the author.

Inputs

Poststatus_idtextRequired: The post to act on. Paste the link to the post, or use an ID from an earlier step.

Outputs

accountobject
applicationobject
bookmarkedtrue/false
cardobject
contenttext
created_attext
edited_attext
emojislist
favouritedtrue/false
favourites_countnumber
filteredlist
idtext
in_reply_to_account_idtext
in_reply_to_idtext
languagetext
media_attachmentslist
mentionslist
mutedtrue/false
pinnedtrue/false
pollobject
reblogobject
rebloggedtrue/false
reblogs_countnumber
replies_countnumber
sensitivetrue/false
spoiler_texttext
tagslist
texttext
uritext
urltext
visibilitytext

Example output

{
  "account": {
    "acct": "lodol",
    "avatar": "https://mastodon.example/avatars/original/missing.png",
    "avatar_static": "https://mastodon.example/avatars/original/missing.png",
    "bot": false,
    "created_at": "2026-01-05T00:00:00.000Z",
    "discoverable": true,
    "display_name": "Lodol",
    "emojis": [],
    "fields": [],
    "followers_count": 17,
    "following_count": 23,
    "group": false,
    "header": "https://mastodon.example/headers/original/missing.png",
    "header_static": "https://mastodon.example/headers/original/missing.png",
    "id": "109876543210987654",
    "indexable": false,
    "last_status_at": "2026-09-14",
    "locked": false,
    "note": "<p>Automation account.</p>",
    "statuses_count": 42,
    "uri": "https://mastodon.example/users/lodol",
    "url": "https://mastodon.example/@lodol",
    "username": "lodol"
  },
  "bookmarked": true,
  "card": null,
  "content": "<p>Hello from a workflow.</p>",
  "created_at": "2026-09-14T09:30:00.000Z",
  "emojis": [],
  "favourited": false,
  "favourites_count": 0,
  "id": "109876543210987655",
  "in_reply_to_account_id": null,
  "in_reply_to_id": null,
  "language": "en",
  "media_attachments": [],
  "mentions": [],
  "pinned": false,
  "poll": null,
  "reblog": null,
  "reblogged": false,
  "reblogs_count": 0,
  "replies_count": 0,
  "sensitive": false,
  "spoiler_text": "",
  "tags": [],
  "uri": "https://mastodon.example/users/lodol/statuses/109876543210987655",
  "url": "https://mastodon.example/@lodol/109876543210987655",
  "visibility": "public"
}

Boost post

Boost a post to this account's followers. What comes back is the boost itself; the post that was boosted is inside it, under 'reblog'. A boost cannot be direct, so this offers three visibilities where publishing offers four.

Inputs

Poststatus_idtextRequired: The post to act on. Paste the link to the post, or use an ID from an earlier step.
Who sees the boostvisibilitytext: Defaults to public.One of: public (Public (timelines and search)), unlisted (Unlisted (not on public timelines)), private (Followers only).

Outputs

accountobject
applicationobject
bookmarkedtrue/false
cardobject
contenttext
created_attext
edited_attext
emojislist
favouritedtrue/false
favourites_countnumber
filteredlist
idtext
in_reply_to_account_idtext
in_reply_to_idtext
languagetext
media_attachmentslist
mentionslist
mutedtrue/false
pinnedtrue/false
pollobject
reblogobject
rebloggedtrue/false
reblogs_countnumber
replies_countnumber
sensitivetrue/false
spoiler_texttext
tagslist
texttext
uritext
urltext
visibilitytext

Example output

{
  "account": {
    "acct": "lodol",
    "avatar": "https://mastodon.example/avatars/original/missing.png",
    "avatar_static": "https://mastodon.example/avatars/original/missing.png",
    "bot": false,
    "created_at": "2026-01-05T00:00:00.000Z",
    "discoverable": true,
    "display_name": "Lodol",
    "emojis": [],
    "fields": [],
    "followers_count": 17,
    "following_count": 23,
    "group": false,
    "header": "https://mastodon.example/headers/original/missing.png",
    "header_static": "https://mastodon.example/headers/original/missing.png",
    "id": "109876543210987654",
    "indexable": false,
    "last_status_at": "2026-09-14",
    "locked": false,
    "note": "<p>Automation account.</p>",
    "statuses_count": 42,
    "uri": "https://mastodon.example/users/lodol",
    "url": "https://mastodon.example/@lodol",
    "username": "lodol"
  },
  "bookmarked": false,
  "card": null,
  "content": "",
  "created_at": "2026-09-14T09:30:00.000Z",
  "emojis": [],
  "favourited": false,
  "favourites_count": 0,
  "id": "109876543210987656",
  "in_reply_to_account_id": null,
  "in_reply_to_id": null,
  "language": "en",
  "media_attachments": [],
  "mentions": [],
  "pinned": false,
  "poll": null,
  "reblog": {
    "account": {
      "acct": "lodol",
      "avatar": "https://mastodon.example/avatars/original/missing.png",
      "avatar_static": "https://mastodon.example/avatars/original/missing.png",
      "bot": false,
      "created_at": "2026-01-05T00:00:00.000Z",
      "discoverable": true,
      "display_name": "Lodol",
      "emojis": [],
      "fields": [],
      "followers_count": 17,
      "following_count": 23,
      "group": false,
      "header": "https://mastodon.example/headers/original/missing.png",
      "header_static": "https://mastodon.example/headers/original/missing.png",
      "id": "109876543210987654",
      "indexable": false,
      "last_status_at": "2026-09-14",
      "locked": false,
      "note": "<p>Automation account.</p>",
      "statuses_count": 42,
      "uri": "https://mastodon.example/users/lodol",
      "url": "https://mastodon.example/@lodol",
      "username": "lodol"
    },
    "bookmarked": false,
    "card": null,
    "content": "<p>Hello from a workflow.</p>",
    "created_at": "2026-09-14T09:30:00.000Z",
    "emojis": [],
    "favourited": false,
    "favourites_count": 0,
    "id": "109876543210987655",
    "in_reply_to_account_id": null,
    "in_reply_to_id": null,
    "language": "en",
    "media_attachments": [],
    "mentions": [],
    "pinned": false,
    "poll": null,
    "reblog": null,
    "reblogged": false,
    "reblogs_count": 0,
    "replies_count": 0,
    "sensitive": false,
    "spoiler_text": "",
    "tags": [],
    "uri": "https://mastodon.example/users/lodol/statuses/109876543210987655",
    "url": "https://mastodon.example/@lodol/109876543210987655",
    "visibility": "public"
  },
  "reblogged": false,
  "reblogs_count": 0,
  "replies_count": 0,
  "sensitive": false,
  "spoiler_text": "",
  "tags": [],
  "uri": "https://mastodon.example/users/lodol/statuses/109876543210987655",
  "url": "https://mastodon.example/@lodol/109876543210987655",
  "visibility": "public"
}

Delete post

Delete one of this account's own posts. The deleted post comes back with its plain source text filled in, so a workflow can repost or edit it. Mastodon allows only 30 deletes every 30 minutes, a budget it shares with removing boosts.

Inputs

Poststatus_idtextRequired: The post to act on. Paste the link to the post, or use an ID from an earlier step.

Outputs

accountobject
applicationobject
bookmarkedtrue/false
cardobject
contenttext
created_attext
edited_attext
emojislist
favouritedtrue/false
favourites_countnumber
filteredlist
idtext
in_reply_to_account_idtext
in_reply_to_idtext
languagetext
media_attachmentslist
mentionslist
mutedtrue/false
pinnedtrue/false
pollobject
reblogobject
rebloggedtrue/false
reblogs_countnumber
replies_countnumber
sensitivetrue/false
spoiler_texttext
tagslist
texttext
uritext
urltext
visibilitytext

Example output

{
  "account": {
    "acct": "lodol",
    "avatar": "https://mastodon.example/avatars/original/missing.png",
    "avatar_static": "https://mastodon.example/avatars/original/missing.png",
    "bot": false,
    "created_at": "2026-01-05T00:00:00.000Z",
    "discoverable": true,
    "display_name": "Lodol",
    "emojis": [],
    "fields": [],
    "followers_count": 17,
    "following_count": 23,
    "group": false,
    "header": "https://mastodon.example/headers/original/missing.png",
    "header_static": "https://mastodon.example/headers/original/missing.png",
    "id": "109876543210987654",
    "indexable": false,
    "last_status_at": "2026-09-14",
    "locked": false,
    "note": "<p>Automation account.</p>",
    "statuses_count": 42,
    "uri": "https://mastodon.example/users/lodol",
    "url": "https://mastodon.example/@lodol",
    "username": "lodol"
  },
  "bookmarked": false,
  "card": null,
  "content": "<p>Hello from a workflow.</p>",
  "created_at": "2026-09-14T09:30:00.000Z",
  "emojis": [],
  "favourited": false,
  "favourites_count": 0,
  "id": "109876543210987655",
  "in_reply_to_account_id": null,
  "in_reply_to_id": null,
  "language": "en",
  "media_attachments": [],
  "mentions": [],
  "pinned": false,
  "poll": null,
  "reblog": null,
  "reblogged": false,
  "reblogs_count": 0,
  "replies_count": 0,
  "sensitive": false,
  "spoiler_text": "",
  "tags": [],
  "text": "Hello from a workflow.",
  "uri": "https://mastodon.example/users/lodol/statuses/109876543210987655",
  "url": "https://mastodon.example/@lodol/109876543210987655",
  "visibility": "public"
}

Favourite post

Favourite a post. The post comes back with 'favourited' set and its favourites count updated.

Inputs

Poststatus_idtextRequired: The post to act on. Paste the link to the post, or use an ID from an earlier step.

Outputs

accountobject
applicationobject
bookmarkedtrue/false
cardobject
contenttext
created_attext
edited_attext
emojislist
favouritedtrue/false
favourites_countnumber
filteredlist
idtext
in_reply_to_account_idtext
in_reply_to_idtext
languagetext
media_attachmentslist
mentionslist
mutedtrue/false
pinnedtrue/false
pollobject
reblogobject
rebloggedtrue/false
reblogs_countnumber
replies_countnumber
sensitivetrue/false
spoiler_texttext
tagslist
texttext
uritext
urltext
visibilitytext

Example output

{
  "account": {
    "acct": "lodol",
    "avatar": "https://mastodon.example/avatars/original/missing.png",
    "avatar_static": "https://mastodon.example/avatars/original/missing.png",
    "bot": false,
    "created_at": "2026-01-05T00:00:00.000Z",
    "discoverable": true,
    "display_name": "Lodol",
    "emojis": [],
    "fields": [],
    "followers_count": 17,
    "following_count": 23,
    "group": false,
    "header": "https://mastodon.example/headers/original/missing.png",
    "header_static": "https://mastodon.example/headers/original/missing.png",
    "id": "109876543210987654",
    "indexable": false,
    "last_status_at": "2026-09-14",
    "locked": false,
    "note": "<p>Automation account.</p>",
    "statuses_count": 42,
    "uri": "https://mastodon.example/users/lodol",
    "url": "https://mastodon.example/@lodol",
    "username": "lodol"
  },
  "bookmarked": false,
  "card": null,
  "content": "<p>Hello from a workflow.</p>",
  "created_at": "2026-09-14T09:30:00.000Z",
  "emojis": [],
  "favourited": true,
  "favourites_count": 1,
  "id": "109876543210987655",
  "in_reply_to_account_id": null,
  "in_reply_to_id": null,
  "language": "en",
  "media_attachments": [],
  "mentions": [],
  "pinned": false,
  "poll": null,
  "reblog": null,
  "reblogged": false,
  "reblogs_count": 0,
  "replies_count": 0,
  "sensitive": false,
  "spoiler_text": "",
  "tags": [],
  "uri": "https://mastodon.example/users/lodol/statuses/109876543210987655",
  "url": "https://mastodon.example/@lodol/109876543210987655",
  "visibility": "public"
}

Follow account

Follow an account. A locked account turns this into a request instead: what comes back then has 'requested' set and 'following' clear, and nothing is followed until its owner approves.

Inputs

AccountaccounttextRequired: The account to act on. Use a handle such as @someone@mastodon.social, a link to their profile, or an account ID from an earlier step.
Show their boostsreblogstrue/false: Include this account's boosts on the home timeline. On by default.
Notify me of their postsnotifytrue/false: Send a notification whenever this account posts. Off by default.
Only these languageslanguageslist: Show only this account's posts in these languages. Leave empty for all of them.

Outputs

blocked_bytrue/false
blockingtrue/false
domain_blockingtrue/false
endorsedtrue/false
followed_bytrue/false
followingtrue/false
idtext
languageslist
mutingtrue/false
muting_notificationstrue/false
notetext
notifyingtrue/false
requestedtrue/false
requested_bytrue/false
showing_reblogstrue/false

Example output

{
  "blocked_by": false,
  "blocking": false,
  "domain_blocking": false,
  "endorsed": false,
  "followed_by": false,
  "following": true,
  "id": "109876543210987654",
  "languages": null,
  "muting": false,
  "muting_notifications": false,
  "note": "",
  "notifying": false,
  "requested": false,
  "requested_by": false,
  "showing_reblogs": true
}

Get a post's thread

Read the thread around a post: the posts it replies to, and every reply below it. This is how a workflow reads the answers to something it published.

Inputs

Poststatus_idtextRequired: The post to act on. Paste the link to the post, or use an ID from an earlier step.

Outputs

The posts above and below one post in its thread

ancestor_countnumber: How many posts come before this one
ancestorslist
descendant_countnumber: How many replies come after it
descendantslist
status_idtext: The post that was read

Example output

{
  "ancestor_count": 0,
  "ancestors": [],
  "descendant_count": 1,
  "descendants": [
    {
      "account": {
        "acct": "lodol",
        "avatar": "https://mastodon.example/avatars/original/missing.png",
        "avatar_static": "https://mastodon.example/avatars/original/missing.png",
        "bot": false,
        "created_at": "2026-01-05T00:00:00.000Z",
        "discoverable": true,
        "display_name": "Lodol",
        "emojis": [],
        "fields": [],
        "followers_count": 17,
        "following_count": 23,
        "group": false,
        "header": "https://mastodon.example/headers/original/missing.png",
        "header_static": "https://mastodon.example/headers/original/missing.png",
        "id": "109876543210987654",
        "indexable": false,
        "last_status_at": "2026-09-14",
        "locked": false,
        "note": "<p>Automation account.</p>",
        "statuses_count": 42,
        "uri": "https://mastodon.example/users/lodol",
        "url": "https://mastodon.example/@lodol",
        "username": "lodol"
      },
      "bookmarked": false,
      "card": null,
      "content": "<p>Hello from a workflow.</p>",
      "created_at": "2026-09-14T09:30:00.000Z",
      "emojis": [],
      "favourited": false,
      "favourites_count": 0,
      "id": "109876543210987655",
      "in_reply_to_account_id": null,
      "in_reply_to_id": null,
      "language": "en",
      "media_attachments": [],
      "mentions": [],
      "pinned": false,
      "poll": null,
      "reblog": null,
      "reblogged": false,
      "reblogs_count": 0,
      "replies_count": 0,
      "sensitive": false,
      "spoiler_text": "",
      "tags": [],
      "uri": "https://mastodon.example/users/lodol/statuses/109876543210987655",
      "url": "https://mastodon.example/@lodol/109876543210987655",
      "visibility": "public"
    }
  ],
  "status_id": "109876543210987655"
}

Get hashtag timeline

Read the public posts carrying a hashtag, optionally narrowed by other tags. Only public posts appear here: a post published as unlisted, followers-only or direct is never on a hashtag timeline, however it is tagged.

Inputs

HashtaghashtagtextRequired: The tag to read, with or without its '#'. One tag, no spaces.
Also tagged with any ofany_tagslist: Keep only posts that also carry one of these tags.
Also tagged with all ofall_tagslist: Keep only posts that carry every one of these tags.
Not tagged with any ofnone_tagslist: Drop posts that carry any of these tags.
Which postsscopetext: Whether to include posts from other instances.One of: all (Everything this instance sees), local (Only posts from this instance), remote (Only posts from other instances).
Only posts with mediaonly_mediatrue/false: Leave out posts that have no image, video or audio attached.
How manylimitnumber: How many to return, up to 40. Mastodon returns 20 when this is empty.From 1 to 40.
Older than (ID)max_idtext: Return only results older than this ID. Pass the previous step's 'next_max_id' to read the next page.
Newer than (ID)since_idtext: Return only results newer than this ID, starting from the newest.
Immediately after (ID)min_idtext: Return the results immediately newer than this ID, starting from the oldest of them. Use this to poll for what has appeared since last time.

Outputs

The public posts carrying this hashtag

countnumber: How many came back
has_moretrue/false: Whether the instance offered an older page
hashtagtext: The tag that was read
itemslist
next_max_idtext: Pass as 'Older than (ID)' to read the next, older page
prev_min_idtext: Pass as 'Immediately after (ID)' to read what arrives next

Example output

{
  "count": 1,
  "has_more": false,
  "hashtag": "introductions",
  "items": [
    {
      "account": {
        "acct": "lodol",
        "avatar": "https://mastodon.example/avatars/original/missing.png",
        "avatar_static": "https://mastodon.example/avatars/original/missing.png",
        "bot": false,
        "created_at": "2026-01-05T00:00:00.000Z",
        "discoverable": true,
        "display_name": "Lodol",
        "emojis": [],
        "fields": [],
        "followers_count": 17,
        "following_count": 23,
        "group": false,
        "header": "https://mastodon.example/headers/original/missing.png",
        "header_static": "https://mastodon.example/headers/original/missing.png",
        "id": "109876543210987654",
        "indexable": false,
        "last_status_at": "2026-09-14",
        "locked": false,
        "note": "<p>Automation account.</p>",
        "statuses_count": 42,
        "uri": "https://mastodon.example/users/lodol",
        "url": "https://mastodon.example/@lodol",
        "username": "lodol"
      },
      "bookmarked": false,
      "card": null,
      "content": "<p>Hello from a workflow.</p>",
      "created_at": "2026-09-14T09:30:00.000Z",
      "emojis": [],
      "favourited": false,
      "favourites_count": 0,
      "id": "109876543210987655",
      "in_reply_to_account_id": null,
      "in_reply_to_id": null,
      "language": "en",
      "media_attachments": [],
      "mentions": [],
      "pinned": false,
      "poll": null,
      "reblog": null,
      "reblogged": false,
      "reblogs_count": 0,
      "replies_count": 0,
      "sensitive": false,
      "spoiler_text": "",
      "tags": [],
      "uri": "https://mastodon.example/users/lodol/statuses/109876543210987655",
      "url": "https://mastodon.example/@lodol/109876543210987655",
      "visibility": "public"
    }
  ],
  "next_max_id": "109876543210987655",
  "prev_min_id": "109876543210987655"
}

Get home timeline

Read this account's own home timeline - the posts from the accounts and hashtags it follows, newest first.

Inputs

How manylimitnumber: How many to return, up to 40. Mastodon returns 20 when this is empty.From 1 to 40.
Older than (ID)max_idtext: Return only results older than this ID. Pass the previous step's 'next_max_id' to read the next page.
Newer than (ID)since_idtext: Return only results newer than this ID, starting from the newest.
Immediately after (ID)min_idtext: Return the results immediately newer than this ID, starting from the oldest of them. Use this to poll for what has appeared since last time.

Outputs

The posts on this account's home timeline

countnumber: How many came back
has_moretrue/false: Whether the instance offered an older page
itemslist
next_max_idtext: Pass as 'Older than (ID)' to read the next, older page
prev_min_idtext: Pass as 'Immediately after (ID)' to read what arrives next

Example output

{
  "count": 1,
  "has_more": false,
  "items": [
    {
      "account": {
        "acct": "lodol",
        "avatar": "https://mastodon.example/avatars/original/missing.png",
        "avatar_static": "https://mastodon.example/avatars/original/missing.png",
        "bot": false,
        "created_at": "2026-01-05T00:00:00.000Z",
        "discoverable": true,
        "display_name": "Lodol",
        "emojis": [],
        "fields": [],
        "followers_count": 17,
        "following_count": 23,
        "group": false,
        "header": "https://mastodon.example/headers/original/missing.png",
        "header_static": "https://mastodon.example/headers/original/missing.png",
        "id": "109876543210987654",
        "indexable": false,
        "last_status_at": "2026-09-14",
        "locked": false,
        "note": "<p>Automation account.</p>",
        "statuses_count": 42,
        "uri": "https://mastodon.example/users/lodol",
        "url": "https://mastodon.example/@lodol",
        "username": "lodol"
      },
      "bookmarked": false,
      "card": null,
      "content": "<p>Hello from a workflow.</p>",
      "created_at": "2026-09-14T09:30:00.000Z",
      "emojis": [],
      "favourited": false,
      "favourites_count": 0,
      "id": "109876543210987655",
      "in_reply_to_account_id": null,
      "in_reply_to_id": null,
      "language": "en",
      "media_attachments": [],
      "mentions": [],
      "pinned": false,
      "poll": null,
      "reblog": null,
      "reblogged": false,
      "reblogs_count": 0,
      "replies_count": 0,
      "sensitive": false,
      "spoiler_text": "",
      "tags": [],
      "uri": "https://mastodon.example/users/lodol/statuses/109876543210987655",
      "url": "https://mastodon.example/@lodol/109876543210987655",
      "visibility": "public"
    }
  ],
  "next_max_id": "109876543210987655",
  "prev_min_id": "109876543210987655"
}

Get instance

Read what the connected server is and what it allows: its title, version, languages, rules and its limits - including 'configuration.statuses.max_characters', the longest post it accepts, which differs from server to server.

Inputs

None.

Outputs

api_versionsobject
configurationobject
contactobject
descriptiontext
domaintext
iconlist
languageslist
registrationsobject
ruleslist
source_urltext
thumbnailobject
titletext
usageobject
versiontext

Example output

{
  "api_versions": {
    "mastodon": 10
  },
  "configuration": {
    "statuses": {
      "max_characters": 500
    }
  },
  "description": "An example Mastodon server.",
  "domain": "mastodon.example",
  "languages": [
    "en"
  ],
  "rules": [],
  "source_url": "https://github.com/mastodon/mastodon",
  "title": "Mastodon Example",
  "version": "4.6.3"
}

Get my account

Read the account this connection acts as: its handle, ID, display name, counts and its own posting defaults. The ID it returns is what the account actions take.

Inputs

None.

Outputs

accttext
avatartext
avatar_statictext
bottrue/false
created_attext
discoverabletrue/false
display_nametext
emojislist
fieldslist
followers_countnumber
following_countnumber
grouptrue/false
headertext
header_statictext
hide_collectionstrue/false
idtext
indexabletrue/false
last_status_attext
limitedtrue/false
lockedtrue/false
memorialtrue/false
movedobject
noindextrue/false
notetext
roleobject
roleslist
sourceobject
statuses_countnumber
suspendedtrue/false
uritext
urltext
usernametext

Example output

{
  "acct": "lodol",
  "avatar": "https://mastodon.example/avatars/original/missing.png",
  "avatar_static": "https://mastodon.example/avatars/original/missing.png",
  "bot": false,
  "created_at": "2026-01-05T00:00:00.000Z",
  "discoverable": true,
  "display_name": "Lodol",
  "emojis": [],
  "fields": [],
  "followers_count": 17,
  "following_count": 23,
  "group": false,
  "header": "https://mastodon.example/headers/original/missing.png",
  "header_static": "https://mastodon.example/headers/original/missing.png",
  "id": "109876543210987654",
  "indexable": false,
  "last_status_at": "2026-09-14",
  "locked": false,
  "note": "<p>Automation account.</p>",
  "statuses_count": 42,
  "uri": "https://mastodon.example/users/lodol",
  "url": "https://mastodon.example/@lodol",
  "username": "lodol"
}

Get post

Read one post in full: who wrote it, its text, its counts, its attachments and whether this account has favourited, boosted or bookmarked it.

Inputs

Poststatus_idtextRequired: The post to act on. Paste the link to the post, or use an ID from an earlier step.

Outputs

accountobject
applicationobject
bookmarkedtrue/false
cardobject
contenttext
created_attext
edited_attext
emojislist
favouritedtrue/false
favourites_countnumber
filteredlist
idtext
in_reply_to_account_idtext
in_reply_to_idtext
languagetext
media_attachmentslist
mentionslist
mutedtrue/false
pinnedtrue/false
pollobject
reblogobject
rebloggedtrue/false
reblogs_countnumber
replies_countnumber
sensitivetrue/false
spoiler_texttext
tagslist
texttext
uritext
urltext
visibilitytext

Example output

{
  "account": {
    "acct": "lodol",
    "avatar": "https://mastodon.example/avatars/original/missing.png",
    "avatar_static": "https://mastodon.example/avatars/original/missing.png",
    "bot": false,
    "created_at": "2026-01-05T00:00:00.000Z",
    "discoverable": true,
    "display_name": "Lodol",
    "emojis": [],
    "fields": [],
    "followers_count": 17,
    "following_count": 23,
    "group": false,
    "header": "https://mastodon.example/headers/original/missing.png",
    "header_static": "https://mastodon.example/headers/original/missing.png",
    "id": "109876543210987654",
    "indexable": false,
    "last_status_at": "2026-09-14",
    "locked": false,
    "note": "<p>Automation account.</p>",
    "statuses_count": 42,
    "uri": "https://mastodon.example/users/lodol",
    "url": "https://mastodon.example/@lodol",
    "username": "lodol"
  },
  "bookmarked": false,
  "card": null,
  "content": "<p>Hello from a workflow.</p>",
  "created_at": "2026-09-14T09:30:00.000Z",
  "emojis": [],
  "favourited": false,
  "favourites_count": 0,
  "id": "109876543210987655",
  "in_reply_to_account_id": null,
  "in_reply_to_id": null,
  "language": "en",
  "media_attachments": [],
  "mentions": [],
  "pinned": false,
  "poll": null,
  "reblog": null,
  "reblogged": false,
  "reblogs_count": 0,
  "replies_count": 0,
  "sensitive": false,
  "spoiler_text": "",
  "tags": [],
  "uri": "https://mastodon.example/users/lodol/statuses/109876543210987655",
  "url": "https://mastodon.example/@lodol/109876543210987655",
  "visibility": "public"
}

Get public timeline

Read the instance's public timeline. Some instances turn this off; when they have, the step says so rather than blaming the connection.

Inputs

Which postsscopetext: Whether to include posts from other instances.One of: all (Everything this instance sees), local (Only posts from this instance), remote (Only posts from other instances).
Only posts with mediaonly_mediatrue/false: Leave out posts that have no image, video or audio attached.
How manylimitnumber: How many to return, up to 40. Mastodon returns 20 when this is empty.From 1 to 40.
Older than (ID)max_idtext: Return only results older than this ID. Pass the previous step's 'next_max_id' to read the next page.
Newer than (ID)since_idtext: Return only results newer than this ID, starting from the newest.
Immediately after (ID)min_idtext: Return the results immediately newer than this ID, starting from the oldest of them. Use this to poll for what has appeared since last time.

Outputs

The posts on the instance's public timeline

countnumber: How many came back
has_moretrue/false: Whether the instance offered an older page
itemslist
next_max_idtext: Pass as 'Older than (ID)' to read the next, older page
prev_min_idtext: Pass as 'Immediately after (ID)' to read what arrives next

Example output

{
  "count": 1,
  "has_more": false,
  "items": [
    {
      "account": {
        "acct": "lodol",
        "avatar": "https://mastodon.example/avatars/original/missing.png",
        "avatar_static": "https://mastodon.example/avatars/original/missing.png",
        "bot": false,
        "created_at": "2026-01-05T00:00:00.000Z",
        "discoverable": true,
        "display_name": "Lodol",
        "emojis": [],
        "fields": [],
        "followers_count": 17,
        "following_count": 23,
        "group": false,
        "header": "https://mastodon.example/headers/original/missing.png",
        "header_static": "https://mastodon.example/headers/original/missing.png",
        "id": "109876543210987654",
        "indexable": false,
        "last_status_at": "2026-09-14",
        "locked": false,
        "note": "<p>Automation account.</p>",
        "statuses_count": 42,
        "uri": "https://mastodon.example/users/lodol",
        "url": "https://mastodon.example/@lodol",
        "username": "lodol"
      },
      "bookmarked": false,
      "card": null,
      "content": "<p>Hello from a workflow.</p>",
      "created_at": "2026-09-14T09:30:00.000Z",
      "emojis": [],
      "favourited": false,
      "favourites_count": 0,
      "id": "109876543210987655",
      "in_reply_to_account_id": null,
      "in_reply_to_id": null,
      "language": "en",
      "media_attachments": [],
      "mentions": [],
      "pinned": false,
      "poll": null,
      "reblog": null,
      "reblogged": false,
      "reblogs_count": 0,
      "replies_count": 0,
      "sensitive": false,
      "spoiler_text": "",
      "tags": [],
      "uri": "https://mastodon.example/users/lodol/statuses/109876543210987655",
      "url": "https://mastodon.example/@lodol/109876543210987655",
      "visibility": "public"
    }
  ],
  "next_max_id": "109876543210987655",
  "prev_min_id": "109876543210987655"
}

List an account's posts

Read the posts one account has published, newest first, optionally only the pinned ones, only those with media, or only those carrying a hashtag.

Inputs

AccountaccounttextRequired: The account to act on. Use a handle such as @someone@mastodon.social, a link to their profile, or an account ID from an earlier step.
Leave out repliesexclude_repliestrue/false: Drop posts that are replies to someone.
Leave out boostsexclude_reblogstrue/false: Drop boosts of other people's posts.
Only pinned postspinnedtrue/false: Return only the posts pinned to the profile.
Only tagged withtaggedtext: Return only posts carrying this hashtag, with or without its '#'.
Only posts with mediaonly_mediatrue/false: Leave out posts that have no image, video or audio attached.
How manylimitnumber: How many to return, up to 40. Mastodon returns 20 when this is empty.From 1 to 40.
Older than (ID)max_idtext: Return only results older than this ID. Pass the previous step's 'next_max_id' to read the next page.
Newer than (ID)since_idtext: Return only results newer than this ID, starting from the newest.
Immediately after (ID)min_idtext: Return the results immediately newer than this ID, starting from the oldest of them. Use this to poll for what has appeared since last time.

Outputs

The account's posts

account_idtext: The account whose posts these are
countnumber: How many came back
has_moretrue/false: Whether the instance offered an older page
itemslist
next_max_idtext: Pass as 'Older than (ID)' to read the next, older page
prev_min_idtext: Pass as 'Immediately after (ID)' to read what arrives next

Example output

{
  "account_id": "109876543210987654",
  "count": 1,
  "has_more": false,
  "items": [
    {
      "account": {
        "acct": "lodol",
        "avatar": "https://mastodon.example/avatars/original/missing.png",
        "avatar_static": "https://mastodon.example/avatars/original/missing.png",
        "bot": false,
        "created_at": "2026-01-05T00:00:00.000Z",
        "discoverable": true,
        "display_name": "Lodol",
        "emojis": [],
        "fields": [],
        "followers_count": 17,
        "following_count": 23,
        "group": false,
        "header": "https://mastodon.example/headers/original/missing.png",
        "header_static": "https://mastodon.example/headers/original/missing.png",
        "id": "109876543210987654",
        "indexable": false,
        "last_status_at": "2026-09-14",
        "locked": false,
        "note": "<p>Automation account.</p>",
        "statuses_count": 42,
        "uri": "https://mastodon.example/users/lodol",
        "url": "https://mastodon.example/@lodol",
        "username": "lodol"
      },
      "bookmarked": false,
      "card": null,
      "content": "<p>Hello from a workflow.</p>",
      "created_at": "2026-09-14T09:30:00.000Z",
      "emojis": [],
      "favourited": false,
      "favourites_count": 0,
      "id": "109876543210987655",
      "in_reply_to_account_id": null,
      "in_reply_to_id": null,
      "language": "en",
      "media_attachments": [],
      "mentions": [],
      "pinned": false,
      "poll": null,
      "reblog": null,
      "reblogged": false,
      "reblogs_count": 0,
      "replies_count": 0,
      "sensitive": false,
      "spoiler_text": "",
      "tags": [],
      "uri": "https://mastodon.example/users/lodol/statuses/109876543210987655",
      "url": "https://mastodon.example/@lodol/109876543210987655",
      "visibility": "public"
    }
  ],
  "next_max_id": "109876543210987655",
  "prev_min_id": "109876543210987655"
}

List notifications

Read this account's notifications - mentions, boosts, favourites, new followers and the rest - newest first, optionally narrowed to the kinds you care about.

Inputs

Only these kindstypeslist: Return only these kinds of notification. Leave empty for all of them.One or more of: mention (Mentions), status (New posts from people you subscribed to), reblog (Boosts of your posts), follow (New followers), follow_request (Follow requests), favourite (Favourites of your posts), poll (Polls that ended), update (Posts you interacted with that were edited).
Leave out these kindsexclude_typeslist: Drop these kinds of notification. Do not name a kind that is already in 'Only these kinds'.One or more of: mention (Mentions), status (New posts from people you subscribed to), reblog (Boosts of your posts), follow (New followers), follow_request (Follow requests), favourite (Favourites of your posts), poll (Polls that ended), update (Posts you interacted with that were edited).
Only fromaccounttext: Keep only notifications from this account. A handle, a profile link or an account ID.
How manylimitnumber: How many to return, up to 40. Mastodon returns 20 when this is empty.From 1 to 40.
Older than (ID)max_idtext: Return only results older than this ID. Pass the previous step's 'next_max_id' to read the next page.
Newer than (ID)since_idtext: Return only results newer than this ID, starting from the newest.
Immediately after (ID)min_idtext: Return the results immediately newer than this ID, starting from the oldest of them. Use this to poll for what has appeared since last time.

Outputs

This account's notifications

countnumber: How many came back
has_moretrue/false: Whether the instance offered an older page
itemslist
next_max_idtext: Pass as 'Older than (ID)' to read the next, older page
prev_min_idtext: Pass as 'Immediately after (ID)' to read what arrives next

Example output

{
  "count": 1,
  "has_more": false,
  "items": [
    {
      "account": {
        "acct": "lodol",
        "avatar": "https://mastodon.example/avatars/original/missing.png",
        "avatar_static": "https://mastodon.example/avatars/original/missing.png",
        "bot": false,
        "created_at": "2026-01-05T00:00:00.000Z",
        "discoverable": true,
        "display_name": "Lodol",
        "emojis": [],
        "fields": [],
        "followers_count": 17,
        "following_count": 23,
        "group": false,
        "header": "https://mastodon.example/headers/original/missing.png",
        "header_static": "https://mastodon.example/headers/original/missing.png",
        "id": "109876543210987654",
        "indexable": false,
        "last_status_at": "2026-09-14",
        "locked": false,
        "note": "<p>Automation account.</p>",
        "statuses_count": 42,
        "uri": "https://mastodon.example/users/lodol",
        "url": "https://mastodon.example/@lodol",
        "username": "lodol"
      },
      "created_at": "2026-09-14T09:35:00.000Z",
      "group_key": "ungrouped-34975861",
      "id": "34975861",
      "status": {
        "account": {
          "acct": "lodol",
          "avatar": "https://mastodon.example/avatars/original/missing.png",
          "avatar_static": "https://mastodon.example/avatars/original/missing.png",
          "bot": false,
          "created_at": "2026-01-05T00:00:00.000Z",
          "discoverable": true,
          "display_name": "Lodol",
          "emojis": [],
          "fields": [],
          "followers_count": 17,
          "following_count": 23,
          "group": false,
          "header": "https://mastodon.example/headers/original/missing.png",
          "header_static": "https://mastodon.example/headers/original/missing.png",
          "id": "109876543210987654",
          "indexable": false,
          "last_status_at": "2026-09-14",
          "locked": false,
          "note": "<p>Automation account.</p>",
          "statuses_count": 42,
          "uri": "https://mastodon.example/users/lodol",
          "url": "https://mastodon.example/@lodol",
          "username": "lodol"
        },
        "bookmarked": false,
        "card": null,
        "content": "<p>Hello from a workflow.</p>",
        "created_at": "2026-09-14T09:30:00.000Z",
        "emojis": [],
        "favourited": false,
        "favourites_count": 0,
        "id": "109876543210987655",
        "in_reply_to_account_id": null,
        "in_reply_to_id": null,
        "language": "en",
        "media_attachments": [],
        "mentions": [],
        "pinned": false,
        "poll": null,
        "reblog": null,
        "reblogged": false,
        "reblogs_count": 0,
        "replies_count": 0,
        "sensitive": false,
        "spoiler_text": "",
        "tags": [],
        "uri": "https://mastodon.example/users/lodol/statuses/109876543210987655",
        "url": "https://mastodon.example/@lodol/109876543210987655",
        "visibility": "public"
      },
      "type": "mention"
    }
  ],
  "next_max_id": "34975861",
  "prev_min_id": "34975861"
}

Look up account

Find an account by handle and get its ID, which the other account actions take. This only finds accounts the instance already knows about; for an account nobody here has ever seen, use Search with 'Fetch from other instances' on.

Inputs

HandleaccttextRequired: The handle to look up: 'someone' for an account on this instance, '@someone@mastodon.social' for one elsewhere. Not an ID.

Outputs

accttext
avatartext
avatar_statictext
bottrue/false
created_attext
discoverabletrue/false
display_nametext
emojislist
fieldslist
followers_countnumber
following_countnumber
grouptrue/false
headertext
header_statictext
hide_collectionstrue/false
idtext
indexabletrue/false
last_status_attext
limitedtrue/false
lockedtrue/false
memorialtrue/false
movedobject
noindextrue/false
notetext
roleslist
statuses_countnumber
suspendedtrue/false
uritext
urltext
usernametext

Example output

{
  "acct": "lodol",
  "avatar": "https://mastodon.example/avatars/original/missing.png",
  "avatar_static": "https://mastodon.example/avatars/original/missing.png",
  "bot": false,
  "created_at": "2026-01-05T00:00:00.000Z",
  "discoverable": true,
  "display_name": "Lodol",
  "emojis": [],
  "fields": [],
  "followers_count": 17,
  "following_count": 23,
  "group": false,
  "header": "https://mastodon.example/headers/original/missing.png",
  "header_static": "https://mastodon.example/headers/original/missing.png",
  "id": "109876543210987654",
  "indexable": false,
  "last_status_at": "2026-09-14",
  "locked": false,
  "note": "<p>Automation account.</p>",
  "statuses_count": 42,
  "uri": "https://mastodon.example/users/lodol",
  "url": "https://mastodon.example/@lodol",
  "username": "lodol"
}

Publish a post

Publish a post, optionally as a reply, with a content warning, with a poll, or scheduled for later. Scheduling changes what comes back: a scheduled post's ID belongs to the schedule, not to a published post, and the other post actions cannot use it.

Inputs

PoststatustextRequired: The text of the post. The instance decides the length limit - 500 characters unless its admins raised it.
Who can see itvisibilitytext: Defaults to whatever the account's own posting default is.One of: public (Public (timelines and search)), unlisted (Unlisted (not on public timelines)), private (Followers only), direct (Direct (only the people mentioned)).
Content warningspoiler_texttext: Shown in place of the post until the reader opens it. Leave empty for no warning.
Mark as sensitivesensitivetrue/false: Hide the post behind a click-to-view.
Reply toin_reply_to_idtext: The post this one replies to. Paste its link or use an ID from an earlier step. Leave empty to start a new thread.
Languagelanguagetext: The language the post is written in. Pick one of the instance's languages or type any two-letter code, such as 'de' or 'pt-BR'.
Publish atscheduled_atdate and time: Publish later instead of now. Must be at least five minutes from now.
Poll answerspoll_optionslist: Turn the post into a poll by giving at least two answers. Most instances allow four.
Poll runs forpoll_expires_intext: How long the poll stays open.One of: 300 (5 minutes), 1800 (30 minutes), 3600 (1 hour), 21600 (6 hours), 43200 (12 hours), 86400 (1 day), 172800 (2 days), 259200 (3 days), 604800 (7 days), 1209600 (14 days), 2592000 (30 days).
Allow multiple answerspoll_multipletrue/false: Let a voter choose more than one answer.
Hide results until it endspoll_hide_totalstrue/false: Keep the vote counts hidden while it runs.

Outputs

accountobject
applicationobject
bookmarkedtrue/false
cardobject
contenttext
created_attext
edited_attext
emojislist
favouritedtrue/false
favourites_countnumber
filteredlist
idtext
in_reply_to_account_idtext
in_reply_to_idtext
languagetext
media_attachmentslist
mentionslist
mutedtrue/false
pinnedtrue/false
pollobject
reblogobject
rebloggedtrue/false
reblogs_countnumber
replies_countnumber
sensitivetrue/false
spoiler_texttext
tagslist
texttext
uritext
urltext
visibilitytext

Example output

{
  "account": {
    "acct": "lodol",
    "avatar": "https://mastodon.example/avatars/original/missing.png",
    "avatar_static": "https://mastodon.example/avatars/original/missing.png",
    "bot": false,
    "created_at": "2026-01-05T00:00:00.000Z",
    "discoverable": true,
    "display_name": "Lodol",
    "emojis": [],
    "fields": [],
    "followers_count": 17,
    "following_count": 23,
    "group": false,
    "header": "https://mastodon.example/headers/original/missing.png",
    "header_static": "https://mastodon.example/headers/original/missing.png",
    "id": "109876543210987654",
    "indexable": false,
    "last_status_at": "2026-09-14",
    "locked": false,
    "note": "<p>Automation account.</p>",
    "statuses_count": 42,
    "uri": "https://mastodon.example/users/lodol",
    "url": "https://mastodon.example/@lodol",
    "username": "lodol"
  },
  "bookmarked": false,
  "card": null,
  "content": "<p>Hello from a workflow.</p>",
  "created_at": "2026-09-14T09:30:00.000Z",
  "emojis": [],
  "favourited": false,
  "favourites_count": 0,
  "id": "109876543210987655",
  "in_reply_to_account_id": null,
  "in_reply_to_id": null,
  "language": "en",
  "media_attachments": [],
  "mentions": [],
  "pinned": false,
  "poll": null,
  "reblog": null,
  "reblogged": false,
  "reblogs_count": 0,
  "replies_count": 0,
  "sensitive": false,
  "spoiler_text": "",
  "tags": [],
  "uri": "https://mastodon.example/users/lodol/statuses/109876543210987655",
  "url": "https://mastodon.example/@lodol/109876543210987655",
  "visibility": "public"
}

Remove boost

Undo a boost. Takes the ID of the post that was boosted, not of the boost. Mastodon allows only 30 of these every 30 minutes, a budget it shares with deleting posts.

Inputs

Poststatus_idtextRequired: The post to act on. Paste the link to the post, or use an ID from an earlier step.

Outputs

accountobject
applicationobject
bookmarkedtrue/false
cardobject
contenttext
created_attext
edited_attext
emojislist
favouritedtrue/false
favourites_countnumber
filteredlist
idtext
in_reply_to_account_idtext
in_reply_to_idtext
languagetext
media_attachmentslist
mentionslist
mutedtrue/false
pinnedtrue/false
pollobject
reblogobject
rebloggedtrue/false
reblogs_countnumber
replies_countnumber
sensitivetrue/false
spoiler_texttext
tagslist
texttext
uritext
urltext
visibilitytext

Example output

{
  "account": {
    "acct": "lodol",
    "avatar": "https://mastodon.example/avatars/original/missing.png",
    "avatar_static": "https://mastodon.example/avatars/original/missing.png",
    "bot": false,
    "created_at": "2026-01-05T00:00:00.000Z",
    "discoverable": true,
    "display_name": "Lodol",
    "emojis": [],
    "fields": [],
    "followers_count": 17,
    "following_count": 23,
    "group": false,
    "header": "https://mastodon.example/headers/original/missing.png",
    "header_static": "https://mastodon.example/headers/original/missing.png",
    "id": "109876543210987654",
    "indexable": false,
    "last_status_at": "2026-09-14",
    "locked": false,
    "note": "<p>Automation account.</p>",
    "statuses_count": 42,
    "uri": "https://mastodon.example/users/lodol",
    "url": "https://mastodon.example/@lodol",
    "username": "lodol"
  },
  "bookmarked": false,
  "card": null,
  "content": "<p>Hello from a workflow.</p>",
  "created_at": "2026-09-14T09:30:00.000Z",
  "emojis": [],
  "favourited": false,
  "favourites_count": 0,
  "id": "109876543210987655",
  "in_reply_to_account_id": null,
  "in_reply_to_id": null,
  "language": "en",
  "media_attachments": [],
  "mentions": [],
  "pinned": false,
  "poll": null,
  "reblog": null,
  "reblogged": false,
  "reblogs_count": 0,
  "replies_count": 0,
  "sensitive": false,
  "spoiler_text": "",
  "tags": [],
  "uri": "https://mastodon.example/users/lodol/statuses/109876543210987655",
  "url": "https://mastodon.example/@lodol/109876543210987655",
  "visibility": "public"
}

Remove favourite

Take back a favourite on a post.

Inputs

Poststatus_idtextRequired: The post to act on. Paste the link to the post, or use an ID from an earlier step.

Outputs

accountobject
applicationobject
bookmarkedtrue/false
cardobject
contenttext
created_attext
edited_attext
emojislist
favouritedtrue/false
favourites_countnumber
filteredlist
idtext
in_reply_to_account_idtext
in_reply_to_idtext
languagetext
media_attachmentslist
mentionslist
mutedtrue/false
pinnedtrue/false
pollobject
reblogobject
rebloggedtrue/false
reblogs_countnumber
replies_countnumber
sensitivetrue/false
spoiler_texttext
tagslist
texttext
uritext
urltext
visibilitytext

Example output

{
  "account": {
    "acct": "lodol",
    "avatar": "https://mastodon.example/avatars/original/missing.png",
    "avatar_static": "https://mastodon.example/avatars/original/missing.png",
    "bot": false,
    "created_at": "2026-01-05T00:00:00.000Z",
    "discoverable": true,
    "display_name": "Lodol",
    "emojis": [],
    "fields": [],
    "followers_count": 17,
    "following_count": 23,
    "group": false,
    "header": "https://mastodon.example/headers/original/missing.png",
    "header_static": "https://mastodon.example/headers/original/missing.png",
    "id": "109876543210987654",
    "indexable": false,
    "last_status_at": "2026-09-14",
    "locked": false,
    "note": "<p>Automation account.</p>",
    "statuses_count": 42,
    "uri": "https://mastodon.example/users/lodol",
    "url": "https://mastodon.example/@lodol",
    "username": "lodol"
  },
  "bookmarked": false,
  "card": null,
  "content": "<p>Hello from a workflow.</p>",
  "created_at": "2026-09-14T09:30:00.000Z",
  "emojis": [],
  "favourited": false,
  "favourites_count": 0,
  "id": "109876543210987655",
  "in_reply_to_account_id": null,
  "in_reply_to_id": null,
  "language": "en",
  "media_attachments": [],
  "mentions": [],
  "pinned": false,
  "poll": null,
  "reblog": null,
  "reblogged": false,
  "reblogs_count": 0,
  "replies_count": 0,
  "sensitive": false,
  "spoiler_text": "",
  "tags": [],
  "uri": "https://mastodon.example/users/lodol/statuses/109876543210987655",
  "url": "https://mastodon.example/@lodol/109876543210987655",
  "visibility": "public"
}

Search

Search this instance for accounts, hashtags and posts. An empty 'statuses' list is normal: searching the full text of other people's posts needs the instance to run Elasticsearch, and without it Mastodon only matches this account's own posts and anything it can resolve as a link.

Inputs

Search forquerytextRequired: What to look for: words, a handle, a hashtag, or the link to a post or profile.
Only look forsearch_typetext: Narrow the search to one kind of result. Leave empty to get all three.One of: accounts, hashtags, statuses (Posts).
Fetch from other instancesresolvetrue/false: Look a handle or link up on its own server when this instance has not seen it before. Needed to find an account nobody here follows yet.
Only accounts I followfollowingtrue/false: Leave out accounts this account does not follow.
Only posts byaccounttext: Keep only posts written by this account. A handle, a profile link or an account ID.
Only reviewed hashtagsexclude_unreviewedtrue/false: Leave out hashtags the instance's moderators have not reviewed.
How many of eachlimitnumber: How many accounts, posts and hashtags to return each, up to 40.From 1 to 40.
Skipoffsetnumber: Skip this many results to read a further page. Only works alongside 'Only look for'.From 0 to 10000.

Outputs

What the instance found

account_countnumber: Accounts found
accountslist
hashtag_countnumber: Hashtags found
hashtagslist
status_countnumber: Posts found
statuseslist

Example output

{
  "account_count": 1,
  "accounts": [
    {
      "acct": "lodol",
      "avatar": "https://mastodon.example/avatars/original/missing.png",
      "avatar_static": "https://mastodon.example/avatars/original/missing.png",
      "bot": false,
      "created_at": "2026-01-05T00:00:00.000Z",
      "discoverable": true,
      "display_name": "Lodol",
      "emojis": [],
      "fields": [],
      "followers_count": 17,
      "following_count": 23,
      "group": false,
      "header": "https://mastodon.example/headers/original/missing.png",
      "header_static": "https://mastodon.example/headers/original/missing.png",
      "id": "109876543210987654",
      "indexable": false,
      "last_status_at": "2026-09-14",
      "locked": false,
      "note": "<p>Automation account.</p>",
      "statuses_count": 42,
      "uri": "https://mastodon.example/users/lodol",
      "url": "https://mastodon.example/@lodol",
      "username": "lodol"
    }
  ],
  "hashtag_count": 1,
  "hashtags": [
    {
      "history": [],
      "name": "introductions",
      "url": "https://mastodon.example/tags/introductions"
    }
  ],
  "status_count": 0,
  "statuses": []
}

Unfollow account

Stop following an account, or withdraw a follow request that is still waiting for approval.

Inputs

AccountaccounttextRequired: The account to act on. Use a handle such as @someone@mastodon.social, a link to their profile, or an account ID from an earlier step.

Outputs

blocked_bytrue/false
blockingtrue/false
domain_blockingtrue/false
endorsedtrue/false
followed_bytrue/false
followingtrue/false
idtext
languageslist
mutingtrue/false
muting_notificationstrue/false
notetext
notifyingtrue/false
requestedtrue/false
requested_bytrue/false
showing_reblogstrue/false

Example output

{
  "blocked_by": false,
  "blocking": false,
  "domain_blocking": false,
  "endorsed": false,
  "followed_by": false,
  "following": false,
  "id": "109876543210987654",
  "languages": null,
  "muting": false,
  "muting_notifications": false,
  "note": "",
  "notifying": false,
  "requested": false,
  "requested_by": false,
  "showing_reblogs": true
}

ActionsCopy Anchor Link

Bookmark postCopy Anchor Link

Inputs

Outputs

Boost postCopy Anchor Link

Inputs

Outputs

Delete postCopy Anchor Link

Inputs

Outputs

Favourite postCopy Anchor Link

Inputs

Outputs

Follow accountCopy Anchor Link

Inputs

Outputs

Get a post's threadCopy Anchor Link

Inputs

Outputs

Get hashtag timelineCopy Anchor Link

Inputs

Outputs

Get home timelineCopy Anchor Link

Inputs

Outputs

Get instanceCopy Anchor Link

Inputs

Outputs

Get my accountCopy Anchor Link

Inputs

Outputs

Get postCopy Anchor Link

Inputs

Outputs

Get public timelineCopy Anchor Link

Inputs

Outputs

List an account's postsCopy Anchor Link

Inputs

Outputs

List notificationsCopy Anchor Link

Inputs

Outputs

Look up accountCopy Anchor Link

Inputs

Outputs

Publish a postCopy Anchor Link

Inputs

Outputs

Remove boostCopy Anchor Link

Inputs

Outputs

Remove favouriteCopy Anchor Link

Inputs

Outputs

SearchCopy Anchor Link

Inputs

Outputs

Unfollow accountCopy Anchor Link

Inputs

Outputs

On this page

Actions

Bookmark post

Boost post

Delete post

Favourite post

Follow account

Get a post's thread

Get hashtag timeline

Get home timeline

Get instance

Get my account

Get post

Get public timeline

List an account's posts

List notifications

Look up account

Publish a post

Remove boost

Remove favourite

Search

Unfollow account