---
canonical_url: "https://docs.composio.dev/toolkits/wordpress_com"
markdown_url: "https://docs.composio.dev/toolkits/wordpress_com.md"
product: "platform"
version: null
last_updated: null
---

# WordPress.com

Manage WordPress.com and Jetpack-connected sites, content, media, comments, Reader data, statistics, and supported platform features through the centralized WordPress.com API.

- **Category:** content & files
- **Auth:** OAUTH2
- **Composio-managed OAuth available?** No
- **Tools:** 11
- **Triggers:** 0
- **Slug:** `WORDPRESS_COM`
- **Version:** 20261002_00

## Tools

### Create Draft Post

**Slug:** `WORDPRESS_COM_CREATE_DRAFT_POST`

Create a non-public draft post on an authorized site. This tool never publishes content; use the returned post ID for review, update, and cleanup.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | Yes | Draft title as plain text. |
| `content` | string | No | Draft body as HTML or WordPress block markup. |
| `excerpt` | string | No | Optional draft excerpt. |
| `site_id` | integer | Yes | Numeric site ID returned by WORDPRESS_COM_LIST_SITES. |
| `tag_ids` | array | No | Tag IDs to assign. |
| `category_ids` | array | No | Category IDs to assign. |
| `comment_status` | string ("open" | "closed") | No | Whether comments should be open if the draft is later published. |
| `featured_media_id` | integer | No | Existing media item ID to use as the featured image. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Draft Post

**Slug:** `WORDPRESS_COM_DELETE_DRAFT_POST`

Permanently delete an existing draft post after verifying it is still a draft. The tool refuses to delete published, scheduled, pending, or private posts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post_id` | integer | Yes | ID of a draft post to permanently delete. |
| `site_id` | integer | Yes | Numeric site ID returned by WORDPRESS_COM_LIST_SITES. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Post

**Slug:** `WORDPRESS_COM_GET_POST`

Get one post by ID in editable context, including raw content and its current status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post_id` | integer | Yes | Post ID returned by create, list, or search. |
| `site_id` | integer | Yes | Numeric site ID returned by WORDPRESS_COM_LIST_SITES. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Site Overview

**Slug:** `WORDPRESS_COM_GET_SITE_OVERVIEW`

Get concise identity, plan, capabilities, editable settings, and traffic summary for one authorized site. Settings or stats that are unavailable by capability are reported as unavailable without hiding valid site details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `site_id` | integer | Yes | Numeric site ID returned by WORDPRESS_COM_LIST_SITES. |
| `stats_period` | string ("day" | "week" | "month" | "year") | No | Period for the traffic summary. |
| `stats_periods` | integer | No | Number of periods to aggregate in the traffic summary. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Blogging Prompts

**Slug:** `WORDPRESS_COM_LIST_BLOGGING_PROMPTS`

List WordPress.com writing prompts for a site, optionally filtered by date or text, with agent-controlled pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `year` | integer | No | Return the prompt calendar for this year. |
| `after` | string | No | Return prompts after this ISO 8601 date. |
| `order` | string ("asc" | "desc") | No | Sort direction by prompt date. |
| `before` | string | No | Return prompts before this ISO 8601 date. |
| `cursor` | string | No | Opaque continuation cursor returned by a previous call. |
| `search` | string | No | Limit prompts to text matching this query. |
| `site_id` | integer | Yes | Numeric site ID returned by WORDPRESS_COM_LIST_SITES. |
| `page_size` | integer | No | Maximum prompts in this page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List CMS Resources

**Slug:** `WORDPRESS_COM_LIST_CMS_RESOURCES`

List categories, tags, comments, media, or users for an authorized site through one consistent paginated read tool.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque continuation cursor returned by a previous call. |
| `search` | string | No | Limit results to records matching this text where the resource supports search. |
| `site_id` | integer | Yes | Numeric site ID returned by WORDPRESS_COM_LIST_SITES. |
| `resource` | string ("categories" | "tags" | "comments" | "media" | "users") | Yes | CMS resource collection to list. |
| `page_size` | integer | No | Maximum resources in this page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Content

**Slug:** `WORDPRESS_COM_LIST_CONTENT`

List and search editable posts or pages on an authorized site, including drafts, with compact raw and rendered content fields and agent-controlled pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order` | string ("asc" | "desc") | No | Sort direction. |
| `cursor` | string | No | Opaque continuation cursor returned by a previous call. |
| `search` | string | No | Limit results to content matching this text. |
| `site_id` | integer | Yes | Numeric site ID returned by WORDPRESS_COM_LIST_SITES. |
| `order_by` | string ("date" | "id" | "modified" | "relevance" | "slug" | "title") | No | Field used to sort results. |
| `statuses` | array | No | Filter by provider-defined status names such as draft, pending, private, future, or publish. WordPress sites may register custom statuses; omit this field to use the provider default. |
| `author_id` | integer | No | Limit results to one author ID. |
| `page_size` | integer | No | Maximum content items in this page. |
| `content_type` | string ("posts" | "pages") | Yes | Content collection to list: posts or pages. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Reader Subscriptions

**Slug:** `WORDPRESS_COM_LIST_READER_SUBSCRIPTIONS`

List feeds and sites followed by the connected WordPress.com account without changing subscriptions.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Site Posts

**Slug:** `WORDPRESS_COM_LIST_SITE_POSTS`

Return one page of posts from the WordPress.com REST v1.1 collection, with documented filters, compact post details, the total found count, and an opaque continuation handle.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag` | string | No | Only return posts with this tag name or slug. |
| `after` | string | No | Only return posts dated after this ISO 8601 datetime. |
| `order` | string ("ASC" | "DESC") | No | Sort direction: ASC or DESC. |
| `author` | integer | No | Only return posts by this author user ID. |
| `before` | string | No | Only return posts dated before this ISO 8601 datetime. |
| `search` | string | No | Only return posts matching this search query. |
| `status` | string | No | Comma-separated post statuses, such as publish, private, draft, pending, future, trash, or any. |
| `sticky` | string ("include" | "exclude" | "require") | No | Include sticky posts, exclude them, or require only sticky posts. |
| `context` | string ("display" | "edit") | No | Use display for rendered HTML or edit for unparsed editable content. |
| `exclude` | string | No | Exclude these post IDs as a comma-separated list, such as 93,94. |
| `include` | string | No | Only return these post IDs as a comma-separated list, such as 91,92. |
| `site_id` | string | Yes | Numeric site ID returned by WORDPRESS_COM_LIST_SITES, or a site domain. |
| `category` | string | No | Only return posts with this category name or slug. |
| `meta_key` | string | No | Only return posts containing this metadata key. |
| `order_by` | string ("date" | "modified" | "title" | "comment_count" | "ID") | No | Post field used to order the results. |
| `page_size` | integer | No | Maximum posts to return in this page (1-100). |
| `parent_id` | integer | No | Only return children of this post for hierarchical post types. |
| `post_type` | string | No | Post type to return. Defaults to post; use any for posts and pages. |
| `meta_value` | string | No | Metadata value to match when meta_key is also provided. |
| `page_handle` | string | No | Opaque continuation handle returned as next_page_handle by a previous call; omit for the first page. |
| `exclude_tree` | integer | No | Exclude this post and its descendants for hierarchical post types. |
| `modified_after` | string | No | Only return posts modified after this ISO 8601 datetime. |
| `modified_before` | string | No | Only return posts modified before this ISO 8601 datetime. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Sites

**Slug:** `WORDPRESS_COM_LIST_SITES`

List every WordPress.com or Jetpack-connected site authorized by the global OAuth account, returning stable numeric site IDs and concise capability and plan summaries for use with other tools.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `activity` | string ("all" | "active" | "inactive") | No | Include all sites or filter by active or inactive status. |
| `visibility` | string ("all" | "visible" | "hidden") | No | Include all authorized sites or only sites visible or hidden in the user's site list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Draft Post

**Slug:** `WORDPRESS_COM_UPDATE_DRAFT_POST`

Update title, body, excerpt, taxonomy, featured media, or comment policy for an existing draft. Provide at least one field to update. The tool refuses to modify a post whose current status is not draft.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | Replacement draft title. |
| `content` | string | No | Replacement draft body as HTML or WordPress block markup. |
| `excerpt` | string | No | Replacement excerpt. |
| `post_id` | integer | Yes | ID of a draft post to update. |
| `site_id` | integer | Yes | Numeric site ID returned by WORDPRESS_COM_LIST_SITES. |
| `tag_ids` | array | No | Replacement tag IDs; use an empty list to clear them. |
| `category_ids` | array | No | Replacement category IDs; use an empty list to clear them. |
| `comment_status` | string ("open" | "closed") | No | Replacement comment policy. |
| `featured_media_id` | integer | No | Replacement featured media ID; use 0 to remove it. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |