WordPress

Manage WordPress content

WordPress is the world’s leading open-source content management system, making it easy to publish and manage websites, blogs, and all types of online content. With WordPress, you can create and update posts or pages, organize your content with categories and tags, manage media files, moderate comments, and handle user accounts—allowing you to run everything from personal blogs to complex business sites.

Sim’s integration with WordPress lets your agents automate essential website tasks. You can programmatically create new blog posts with specific titles, content, categories, tags, and featured images. Updating existing posts—such as changing their content, title, or publishing status—is straightforward. You can also publish or save content as drafts, manage static pages, work with media uploads, oversee comments, and assign content to relevant organizational taxonomies.

By connecting WordPress to your automations, Sim empowers your agents to streamline content publishing, editorial workflows, and everyday site management—helping you keep your website fresh, organized, and secure without manual effort.

Usage Instructions

Integrate with WordPress to create, update, and manage posts, pages, media, comments, categories, tags, and users. Supports WordPress.com sites via OAuth and self-hosted WordPress sites using Application Passwords authentication.

Tools

wordpress_create_post

Create a new blog post in WordPress.com

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
titlestringYesPost title
contentstringNoPost content (HTML or plain text)
statusstringNoPost status: publish, draft, pending, private, or future
excerptstringNoPost excerpt
categoriesstringNoComma-separated category IDs
tagsstringNoComma-separated tag IDs
featuredMedianumberNoFeatured image media ID
slugstringNoURL slug for the post

Output

ParameterTypeDescription
postobjectThe created post
idnumberPost ID
datestringPost creation date
modifiedstringPost modification date
slugstringPost slug
statusstringPost status
typestringPost type
linkstringPost URL
titleobjectPost title object
contentobjectPost content object
excerptobjectPost excerpt object
authornumberAuthor ID
featured_medianumberFeatured media ID
categoriesarrayCategory IDs
tagsarrayTag IDs

wordpress_update_post

Update an existing blog post in WordPress.com

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
postIdnumberYesThe ID of the post to update
titlestringNoPost title
contentstringNoPost content (HTML or plain text)
statusstringNoPost status: publish, draft, pending, private, or future
excerptstringNoPost excerpt
categoriesstringNoComma-separated category IDs
tagsstringNoComma-separated tag IDs
featuredMedianumberNoFeatured image media ID
slugstringNoURL slug for the post

Output

ParameterTypeDescription
postobjectThe updated post
idnumberPost ID
datestringPost creation date
modifiedstringPost modification date
slugstringPost slug
statusstringPost status
typestringPost type
linkstringPost URL
titleobjectPost title object
contentobjectPost content object
excerptobjectPost excerpt object
authornumberAuthor ID
featured_medianumberFeatured media ID
categoriesarrayCategory IDs
tagsarrayTag IDs

wordpress_delete_post

Delete a blog post from WordPress.com

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
postIdnumberYesThe ID of the post to delete
forcebooleanNoBypass trash and force delete permanently

Output

ParameterTypeDescription
deletedbooleanWhether the post was deleted
postobjectThe deleted post
idnumberPost ID
datestringPost creation date
modifiedstringPost modification date
slugstringPost slug
statusstringPost status
typestringPost type
linkstringPost URL
titleobjectPost title object
contentobjectPost content object
excerptobjectPost excerpt object
authornumberAuthor ID
featured_medianumberFeatured media ID
categoriesarrayCategory IDs
tagsarrayTag IDs

wordpress_get_post

Get a single blog post from WordPress.com by ID

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
postIdnumberYesThe ID of the post to retrieve

Output

ParameterTypeDescription
postobjectThe retrieved post
idnumberPost ID
datestringPost creation date
modifiedstringPost modification date
slugstringPost slug
statusstringPost status
typestringPost type
linkstringPost URL
titleobjectPost title object
contentobjectPost content object
excerptobjectPost excerpt object
authornumberAuthor ID
featured_medianumberFeatured media ID
categoriesarrayCategory IDs
tagsarrayTag IDs

wordpress_list_posts

List blog posts from WordPress.com with optional filters

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
perPagenumberNoNumber of posts per page (default: 10, max: 100)
pagenumberNoPage number for pagination
statusstringNoPost status filter: publish, draft, pending, private
authornumberNoFilter by author ID
categoriesstringNoComma-separated category IDs to filter by
tagsstringNoComma-separated tag IDs to filter by
searchstringNoSearch term to filter posts
orderBystringNoOrder by field: date, id, title, slug, modified
orderstringNoOrder direction: asc or desc

Output

ParameterTypeDescription
postsarrayList of posts
idnumberPost ID
datestringPost creation date
modifiedstringPost modification date
slugstringPost slug
statusstringPost status
typestringPost type
linkstringPost URL
titleobjectPost title object
contentobjectPost content object
excerptobjectPost excerpt object
authornumberAuthor ID
featured_medianumberFeatured media ID
categoriesarrayCategory IDs
tagsarrayTag IDs
totalnumberTotal number of posts
totalPagesnumberTotal number of pages

wordpress_create_page

Create a new page in WordPress.com

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
titlestringYesPage title
contentstringNoPage content (HTML or plain text)
statusstringNoPage status: publish, draft, pending, private
excerptstringNoPage excerpt
parentnumberNoParent page ID for hierarchical pages
menuOrdernumberNoOrder in page menu
featuredMedianumberNoFeatured image media ID
slugstringNoURL slug for the page

Output

ParameterTypeDescription
pageobjectThe created page
idnumberPage ID
datestringPage creation date
modifiedstringPage modification date
slugstringPage slug
statusstringPage status
typestringContent type
linkstringPage URL
titleobjectPage title object
contentobjectPage content object
excerptobjectPage excerpt object
authornumberAuthor ID
featured_medianumberFeatured media ID
parentnumberParent page ID
menu_ordernumberMenu order

wordpress_update_page

Update an existing page in WordPress.com

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
pageIdnumberYesThe ID of the page to update
titlestringNoPage title
contentstringNoPage content (HTML or plain text)
statusstringNoPage status: publish, draft, pending, private
excerptstringNoPage excerpt
parentnumberNoParent page ID for hierarchical pages
menuOrdernumberNoOrder in page menu
featuredMedianumberNoFeatured image media ID
slugstringNoURL slug for the page

Output

ParameterTypeDescription
pageobjectThe updated page
idnumberPage ID
datestringPage creation date
modifiedstringPage modification date
slugstringPage slug
statusstringPage status
typestringContent type
linkstringPage URL
titleobjectPage title object
contentobjectPage content object
excerptobjectPage excerpt object
authornumberAuthor ID
featured_medianumberFeatured media ID
parentnumberParent page ID
menu_ordernumberMenu order

wordpress_delete_page

Delete a page from WordPress.com

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
pageIdnumberYesThe ID of the page to delete
forcebooleanNoBypass trash and force delete permanently

Output

ParameterTypeDescription
deletedbooleanWhether the page was deleted
pageobjectThe deleted page
idnumberPage ID
datestringPage creation date
modifiedstringPage modification date
slugstringPage slug
statusstringPage status
typestringContent type
linkstringPage URL
titleobjectPage title object
contentobjectPage content object
excerptobjectPage excerpt object
authornumberAuthor ID
featured_medianumberFeatured media ID
parentnumberParent page ID
menu_ordernumberMenu order

wordpress_get_page

Get a single page from WordPress.com by ID

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
pageIdnumberYesThe ID of the page to retrieve

Output

ParameterTypeDescription
pageobjectThe retrieved page
idnumberPage ID
datestringPage creation date
modifiedstringPage modification date
slugstringPage slug
statusstringPage status
typestringContent type
linkstringPage URL
titleobjectPage title object
contentobjectPage content object
excerptobjectPage excerpt object
authornumberAuthor ID
featured_medianumberFeatured media ID
parentnumberParent page ID
menu_ordernumberMenu order

wordpress_list_pages

List pages from WordPress.com with optional filters

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
perPagenumberNoNumber of pages per request (default: 10, max: 100)
pagenumberNoPage number for pagination
statusstringNoPage status filter: publish, draft, pending, private
parentnumberNoFilter by parent page ID
searchstringNoSearch term to filter pages
orderBystringNoOrder by field: date, id, title, slug, modified, menu_order
orderstringNoOrder direction: asc or desc

Output

ParameterTypeDescription
pagesarrayList of pages
idnumberPage ID
datestringPage creation date
modifiedstringPage modification date
slugstringPage slug
statusstringPage status
typestringContent type
linkstringPage URL
titleobjectPage title object
contentobjectPage content object
excerptobjectPage excerpt object
authornumberAuthor ID
featured_medianumberFeatured media ID
parentnumberParent page ID
menu_ordernumberMenu order
totalnumberTotal number of pages
totalPagesnumberTotal number of result pages

wordpress_upload_media

Upload a media file (image, video, document) to WordPress.com

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
filefileNoFile to upload (UserFile object)
filenamestringNoOptional filename override (e.g., image.jpg)
titlestringNoMedia title
captionstringNoMedia caption
altTextstringNoAlternative text for accessibility
descriptionstringNoMedia description

Output

ParameterTypeDescription
mediaobjectThe uploaded media item
idnumberMedia ID
datestringUpload date
slugstringMedia slug
typestringContent type
linkstringMedia page URL
titleobjectMedia title object
captionobjectMedia caption object
alt_textstringAlt text
media_typestringMedia type (image, video, etc.)
mime_typestringMIME type
source_urlstringDirect URL to the media file
media_detailsobjectMedia details (dimensions, etc.)

wordpress_get_media

Get a single media item from WordPress.com by ID

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
mediaIdnumberYesThe ID of the media item to retrieve

Output

ParameterTypeDescription
mediaobjectThe retrieved media item
idnumberMedia ID
datestringUpload date
slugstringMedia slug
typestringContent type
linkstringMedia page URL
titleobjectMedia title object
captionobjectMedia caption object
alt_textstringAlt text
media_typestringMedia type (image, video, etc.)
mime_typestringMIME type
source_urlstringDirect URL to the media file
media_detailsobjectMedia details (dimensions, etc.)

wordpress_list_media

List media items from the WordPress.com media library

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
perPagenumberNoNumber of media items per request (default: 10, max: 100)
pagenumberNoPage number for pagination
searchstringNoSearch term to filter media
mediaTypestringNoFilter by media type: image, video, audio, application
mimeTypestringNoFilter by specific MIME type (e.g., image/jpeg)
orderBystringNoOrder by field: date, id, title, slug
orderstringNoOrder direction: asc or desc

Output

ParameterTypeDescription
mediaarrayList of media items
idnumberMedia ID
datestringUpload date
slugstringMedia slug
typestringContent type
linkstringMedia page URL
titleobjectMedia title object
captionobjectMedia caption object
alt_textstringAlt text
media_typestringMedia type (image, video, etc.)
mime_typestringMIME type
source_urlstringDirect URL to the media file
media_detailsobjectMedia details (dimensions, etc.)
totalnumberTotal number of media items
totalPagesnumberTotal number of result pages

wordpress_delete_media

Delete a media item from WordPress.com

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
mediaIdnumberYesThe ID of the media item to delete
forcebooleanNoForce delete (media has no trash, so deletion is permanent)

Output

ParameterTypeDescription
deletedbooleanWhether the media was deleted
mediaobjectThe deleted media item
idnumberMedia ID
datestringUpload date
slugstringMedia slug
typestringContent type
linkstringMedia page URL
titleobjectMedia title object
captionobjectMedia caption object
alt_textstringAlt text
media_typestringMedia type (image, video, etc.)
mime_typestringMIME type
source_urlstringDirect URL to the media file
media_detailsobjectMedia details (dimensions, etc.)

wordpress_create_comment

Create a new comment on a WordPress.com post

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
postIdnumberYesThe ID of the post to comment on
contentstringYesComment content
parentnumberNoParent comment ID for replies
authorNamestringNoComment author display name
authorEmailstringNoComment author email
authorUrlstringNoComment author URL

Output

ParameterTypeDescription
commentobjectThe created comment
idnumberComment ID
postnumberPost ID
parentnumberParent comment ID
authornumberAuthor user ID
author_namestringAuthor display name
author_emailstringAuthor email
author_urlstringAuthor URL
datestringComment date
contentobjectComment content object
linkstringComment permalink
statusstringComment status

wordpress_list_comments

List comments from WordPress.com with optional filters

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
perPagenumberNoNumber of comments per request (default: 10, max: 100)
pagenumberNoPage number for pagination
postIdnumberNoFilter by post ID
statusstringNoFilter by comment status: approved, hold, spam, trash
searchstringNoSearch term to filter comments
orderBystringNoOrder by field: date, id, parent
orderstringNoOrder direction: asc or desc

Output

ParameterTypeDescription
commentsarrayList of comments
idnumberComment ID
postnumberPost ID
parentnumberParent comment ID
authornumberAuthor user ID
author_namestringAuthor display name
author_emailstringAuthor email
author_urlstringAuthor URL
datestringComment date
contentobjectComment content object
linkstringComment permalink
statusstringComment status
totalnumberTotal number of comments
totalPagesnumberTotal number of result pages

wordpress_update_comment

Update a comment in WordPress.com (content or status)

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
commentIdnumberYesThe ID of the comment to update
contentstringNoUpdated comment content
statusstringNoComment status: approved, hold, spam, trash

Output

ParameterTypeDescription
commentobjectThe updated comment
idnumberComment ID
postnumberPost ID
parentnumberParent comment ID
authornumberAuthor user ID
author_namestringAuthor display name
author_emailstringAuthor email
author_urlstringAuthor URL
datestringComment date
contentobjectComment content object
linkstringComment permalink
statusstringComment status

wordpress_delete_comment

Delete a comment from WordPress.com

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
commentIdnumberYesThe ID of the comment to delete
forcebooleanNoBypass trash and force delete permanently

Output

ParameterTypeDescription
deletedbooleanWhether the comment was deleted
commentobjectThe deleted comment
idnumberComment ID
postnumberPost ID
parentnumberParent comment ID
authornumberAuthor user ID
author_namestringAuthor display name
author_emailstringAuthor email
author_urlstringAuthor URL
datestringComment date
contentobjectComment content object
linkstringComment permalink
statusstringComment status

wordpress_create_category

Create a new category in WordPress.com

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
namestringYesCategory name
descriptionstringNoCategory description
parentnumberNoParent category ID for hierarchical categories
slugstringNoURL slug for the category

Output

ParameterTypeDescription
categoryobjectThe created category
idnumberCategory ID
countnumberNumber of posts in this category
descriptionstringCategory description
linkstringCategory archive URL
namestringCategory name
slugstringCategory slug
taxonomystringTaxonomy name
parentnumberParent category ID

wordpress_list_categories

List categories from WordPress.com

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
perPagenumberNoNumber of categories per request (default: 10, max: 100)
pagenumberNoPage number for pagination
searchstringNoSearch term to filter categories
orderstringNoOrder direction: asc or desc

Output

ParameterTypeDescription
categoriesarrayList of categories
idnumberCategory ID
countnumberNumber of posts in this category
descriptionstringCategory description
linkstringCategory archive URL
namestringCategory name
slugstringCategory slug
taxonomystringTaxonomy name
parentnumberParent category ID
totalnumberTotal number of categories
totalPagesnumberTotal number of result pages

wordpress_create_tag

Create a new tag in WordPress.com

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
namestringYesTag name
descriptionstringNoTag description
slugstringNoURL slug for the tag

Output

ParameterTypeDescription
tagobjectThe created tag
idnumberTag ID
countnumberNumber of posts with this tag
descriptionstringTag description
linkstringTag archive URL
namestringTag name
slugstringTag slug
taxonomystringTaxonomy name

wordpress_list_tags

List tags from WordPress.com

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
perPagenumberNoNumber of tags per request (default: 10, max: 100)
pagenumberNoPage number for pagination
searchstringNoSearch term to filter tags
orderstringNoOrder direction: asc or desc

Output

ParameterTypeDescription
tagsarrayList of tags
idnumberTag ID
countnumberNumber of posts with this tag
descriptionstringTag description
linkstringTag archive URL
namestringTag name
slugstringTag slug
taxonomystringTaxonomy name
totalnumberTotal number of tags
totalPagesnumberTotal number of result pages

wordpress_get_current_user

Get information about the currently authenticated WordPress.com user

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)

Output

ParameterTypeDescription
userobjectThe current user
idnumberUser ID
usernamestringUsername
namestringDisplay name
first_namestringFirst name
last_namestringLast name
emailstringEmail address
urlstringUser website URL
descriptionstringUser bio
linkstringAuthor archive URL
slugstringUser slug
rolesarrayUser roles
avatar_urlsobjectAvatar URLs at different sizes

wordpress_list_users

List users from WordPress.com (requires admin privileges)

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
perPagenumberNoNumber of users per request (default: 10, max: 100)
pagenumberNoPage number for pagination
searchstringNoSearch term to filter users
rolesstringNoComma-separated role names to filter by
orderstringNoOrder direction: asc or desc

Output

ParameterTypeDescription
usersarrayList of users
idnumberUser ID
usernamestringUsername
namestringDisplay name
first_namestringFirst name
last_namestringLast name
emailstringEmail address
urlstringUser website URL
descriptionstringUser bio
linkstringAuthor archive URL
slugstringUser slug
rolesarrayUser roles
avatar_urlsobjectAvatar URLs at different sizes
totalnumberTotal number of users
totalPagesnumberTotal number of result pages

wordpress_get_user

Get a specific user from WordPress.com by ID

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
userIdnumberYesThe ID of the user to retrieve

Output

ParameterTypeDescription
userobjectThe retrieved user
idnumberUser ID
usernamestringUsername
namestringDisplay name
first_namestringFirst name
last_namestringLast name
emailstringEmail address
urlstringUser website URL
descriptionstringUser bio
linkstringAuthor archive URL
slugstringUser slug
rolesarrayUser roles
avatar_urlsobjectAvatar URLs at different sizes

wordpress_search_content

Search across all content types in WordPress.com (posts, pages, media)

Input

ParameterTypeRequiredDescription
siteIdstringYesWordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)
querystringYesSearch query
perPagenumberNoNumber of results per request (default: 10, max: 100)
pagenumberNoPage number for pagination
typestringNoFilter by content type: post, page, attachment
subtypestringNoFilter by post type slug (e.g., post, page)

Output

ParameterTypeDescription
resultsarraySearch results
idnumberContent ID
titlestringContent title
urlstringContent URL
typestringContent type (post, page, attachment)
subtypestringPost type slug
totalnumberTotal number of results
totalPagesnumberTotal number of result pages

On this page

Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started