WordPress
CMS integration · 30 node(s).
00Overview
Manage posts, pages, users, comments, categories, and tags on your WordPress site
Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.
01Connecting WordPress
Add your credentials as a Flomation environment secret, then pick them in each node. The connection fields are:
| Field | Type | Details | |
|---|---|---|---|
| Application Password | secret | Required | Users ▸ Profile ▸ Application Passwords (WP 5.6+) |
| Allow Insecure SSL | boolean | Skip TLS verification — only for self-signed sites |
${secrets.your_secret}.02Category
WordPress: Create Category
cms/wordpress/category_create · Action
Create a category (a hierarchical taxonomy term) on your WordPress site. Set the name, description, slug and parent, or add any other field via Additional Fields.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Name | string | Required | |
| Description | text | ||
| Slug | string | ||
| Parent Category ID | string | ● live picker | Category ID of the parent (leave blank for a top-level category) |
| Meta (JSON) | object | {"my_key":"my_value"} | |
| Additional Fields (JSON) | object |
Returns: id, result, tool_result, success, error
WordPress: Delete Category
cms/wordpress/category_delete · Action
Delete a category from your WordPress site. Taxonomy terms cannot be trashed, so this always deletes the category permanently.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Category ID | string | Required | 123 |
Returns: id, result, tool_result, success, error
WordPress: Get Category
cms/wordpress/category_get · Action
Retrieve a single category from your WordPress site by ID.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Category ID | string | Required | 123 |
| Context | string | choices: View, Edit (more fields; needs edit rights), Embed |
Returns: id, result, tool_result, success, error
WordPress: Get Many Categories
cms/wordpress/category_get_all · Action
List categories from your WordPress site, with optional filters. Enable Return All to auto-paginate every matching category.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Context | string | choices: View, Edit (more fields; needs edit rights), Embed | |
| Return All (auto-paginate every match) | boolean | ||
| Limit (per page) | integer | 50 per page (max 100); Return All still fetches every match | |
| Page | integer | Page number to fetch (ignored when Return All is on) | |
| Search | string | ||
| Parent Category ID | string | ● live picker | Limit to direct children of this category ID |
| Assigned to Post ID | string | Limit to categories assigned to this post ID | |
| Slug | string | ||
| Hide Empty (only categories with posts) | boolean | ||
| Sort Order | string | choices: Descending, Ascending | |
| Order By | string | choices: Name, ID, Slug, Count, Description, Term Group, Include | |
| Include IDs | string | Comma-separated category IDs to include | |
| Exclude IDs | string | Comma-separated category IDs to exclude | |
| Offset | integer | Skip this many results (ignored when Return All is on) |
Returns: results, count, total, total_pages, tool_result, success, error
WordPress: Update Category
cms/wordpress/category_update · Action
Update an existing category on your WordPress site. Only the fields you set are changed; add any other field via Additional Fields.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Category ID | string | Required | 123 |
| Name | string | ||
| Description | text | ||
| Slug | string | ||
| Parent Category ID | string | ● live picker | Category ID of the parent (0 for a top-level category) |
| Meta (JSON) | object | {"my_key":"my_value"} | |
| Additional Fields (JSON) | object |
Returns: id, result, tool_result, success, error
03Comment
WordPress: Create Comment
cms/wordpress/comment_create · Action
Create a comment on a post on your WordPress site. Set the author and body directly, or add any other comment field via Additional Fields.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Post ID | string | Required | ID of the post to comment on |
| Content | text | Required | The comment body |
| Author (User ID) | string | ● live picker | User ID of the comment author (leave blank for the authenticating user) |
| Author Name | string | Display name for an anonymous author | |
| Author Email | string | ||
| Author URL | string | ||
| Parent Comment ID | string | Reply to this comment ID (leave blank for a top-level comment) | |
| Date | datetime | Comment date (defaults to now) | |
| Status | string | choices: Approved, Hold, Spam | |
| Meta (JSON) | object | {"my_key":"my_value"} | |
| Additional Fields (JSON) | object | {"author_ip":"127.0.0.1"} |
Returns: id, result, tool_result, success, error
WordPress: Delete Comment
cms/wordpress/comment_delete · Action
Delete a comment from your WordPress site. Moves it to the Trash by default; enable Permanently Delete to remove it for good.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Comment ID | string | Required | 123 |
| Permanently Delete | boolean | On: delete permanently. Off (default): move to Trash. |
Returns: id, result, tool_result, success, error
WordPress: Get Comment
cms/wordpress/comment_get · Action
Retrieve a single comment from your WordPress site by ID.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Comment ID | string | Required | 123 |
| Context | string | choices: View, Edit (more fields; needs edit rights), Embed | |
| Post Password | string | Required for comments on a password-protected post |
Returns: id, result, tool_result, success, error
WordPress: Get Many Comments
cms/wordpress/comment_get_all · Action
List comments from your WordPress site, with optional filters. Enable Return All to auto-paginate every matching comment.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Context | string | choices: View, Edit (more fields; needs edit rights), Embed | |
| Return All (auto-paginate every match) | boolean | ||
| Limit (per page) | integer | 50 per page (max 100); Return All still fetches every match | |
| Page | integer | Page number to fetch (ignored when Return All is on) | |
| Search | string | ||
| Post ID | string | Limit to comments on this post ID | |
| Status | string | choices: Approved, Hold, Spam, Trash | |
| Author Email | string | ||
| Parent Comment ID | string | Limit to replies to this comment ID | |
| Published After | datetime | ||
| Published Before | datetime | ||
| Sort Order | string | choices: Descending, Ascending | |
| Order By | string | choices: Date, Date GMT, ID, Post, Parent, Type | |
| Include IDs | string | Comma-separated comment IDs to include | |
| Exclude IDs | string | Comma-separated comment IDs to exclude | |
| Offset | integer | Skip this many results (ignored when Return All is on) |
Returns: results, count, total, total_pages, tool_result, success, error
WordPress: Update Comment
cms/wordpress/comment_update · Action
Update an existing comment on your WordPress site. Only the fields you set are changed; add any other comment field via Additional Fields.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Comment ID | string | Required | 123 |
| Content | text | The comment body | |
| Author Name | string | ||
| Author Email | string | ||
| Author URL | string | ||
| Status | string | choices: Approved, Hold, Spam | |
| Date | datetime | ||
| Meta (JSON) | object | {"my_key":"my_value"} | |
| Additional Fields (JSON) | object |
Returns: id, result, tool_result, success, error
04Page
WordPress: Create Page
cms/wordpress/page_create · Action
Create a page on your WordPress site. Set common fields directly (title, content, status, parent, menu order) or add any other page field via Additional Fields.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Title | string | Required | |
| Content | text | HTML or block markup | |
| Excerpt | text | ||
| Status | string | choices: Publish, Draft, Pending Review, Private, Scheduled (future) | |
| Author (User ID) | string | ● live picker | Author user ID (leave blank for the authenticating user) |
| Slug | string | ||
| Parent Page ID | string | ID of the parent page to nest this under | |
| Featured Media (ID) | string | Media/attachment ID for the featured image | |
| Menu Order | string | Sort position among sibling pages, e.g. 0 | |
| Page Password | string | Protect the page with a password (distinct from the Application Password above) | |
| Comments | string | choices: Open, Closed | |
| Pingbacks | string | choices: Open, Closed | |
| Date | datetime | Publish date (defaults to now) | |
| Template | string | ||
| Meta (JSON) | object | {"my_key":"my_value"} | |
| Additional Fields (JSON) | object | {"date_gmt":"2026-01-01T09:00:00"} |
Returns: id, result, tool_result, success, error
WordPress: Delete Page
cms/wordpress/page_delete · Action
Delete a page from your WordPress site. Moves it to the Trash by default; enable Permanently Delete to remove it for good.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Page ID | string | Required | 123 |
| Permanently Delete | boolean | On: delete permanently. Off (default): move to Trash. |
Returns: id, result, tool_result, success, error
WordPress: Get Page
cms/wordpress/page_get · Action
Retrieve a single page from your WordPress site by ID.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Page ID | string | Required | 123 |
| Context | string | choices: View, Edit (more fields; needs edit rights), Embed | |
| Page Password | string | Required to read a password-protected page |
Returns: id, result, tool_result, success, error
WordPress: Get Many Pages
cms/wordpress/page_get_all · Action
List pages from your WordPress site, with optional filters. Enable Return All to auto-paginate every matching page.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Context | string | choices: View, Edit (more fields; needs edit rights), Embed | |
| Return All (auto-paginate every match) | boolean | ||
| Limit (per page) | integer | 50 per page (max 100); Return All still fetches every match | |
| Page | integer | Page number to fetch (ignored when Return All is on) | |
| Search | string | ||
| Status | string | choices: Publish, Draft, Pending Review, Private, Future, Trash, Any | |
| Author (User ID) | string | ● live picker | Limit to pages by this author user ID |
| Parent Page ID | string | Limit to child pages of this parent ID | |
| Slug | string | ||
| Published After | datetime | ||
| Published Before | datetime | ||
| Include IDs | string | Comma-separated page IDs to include | |
| Exclude IDs | string | Comma-separated page IDs to exclude | |
| Sort Order | string | choices: Descending, Ascending | |
| Order By | string | choices: Date, Modified, ID, Title, Slug, Author, Menu Order | |
| Offset | integer | Skip this many results (ignored when Return All is on) |
Returns: results, count, total, total_pages, tool_result, success, error
WordPress: Update Page
cms/wordpress/page_update · Action
Update an existing page on your WordPress site. Only the fields you set are changed; add any other page field via Additional Fields.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Page ID | string | Required | 123 |
| Title | string | ||
| Content | text | HTML or block markup | |
| Excerpt | text | ||
| Status | string | choices: Publish, Draft, Pending Review, Private, Scheduled (future) | |
| Author (User ID) | string | ● live picker | |
| Slug | string | ||
| Parent Page ID | string | ID of the parent page to nest this under | |
| Featured Media (ID) | string | ||
| Menu Order | string | Sort position among sibling pages, e.g. 0 | |
| Page Password | string | ||
| Comments | string | choices: Open, Closed | |
| Pingbacks | string | choices: Open, Closed | |
| Date | datetime | ||
| Template | string | ||
| Meta (JSON) | object | {"my_key":"my_value"} | |
| Additional Fields (JSON) | object |
Returns: id, result, tool_result, success, error
05Post
WordPress: Create Post
cms/wordpress/post_create · Action
Create a post on your WordPress site. Set common fields directly (title, content, status, categories, tags) or add any other post field via Additional Fields.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Title | string | Required | |
| Content | text | HTML or block markup | |
| Excerpt | text | ||
| Status | string | choices: Publish, Draft, Pending Review, Private, Scheduled (future) | |
| Author (User ID) | string | ● live picker | Author user ID (leave blank for the authenticating user) |
| Slug | string | ||
| Category IDs | string | Comma-separated category IDs, e.g. 3,7 | |
| Tag IDs | string | Comma-separated tag IDs, e.g. 12,15 | |
| Format | string | choices: Standard, Aside, Gallery, Link, Image, Quote, Status, Video, Audio, Chat | |
| Featured Media (ID) | string | Media/attachment ID for the featured image | |
| Sticky | boolean | ||
| Post Password | string | Protect the post with a password (distinct from the Application Password above) | |
| Comments | string | choices: Open, Closed | |
| Pingbacks | string | choices: Open, Closed | |
| Date | datetime | Publish date (defaults to now) | |
| Template | string | ||
| Meta (JSON) | object | {"my_key":"my_value"} | |
| Additional Fields (JSON) | object | {"menu_order":1} |
Returns: id, result, tool_result, success, error
WordPress: Delete Post
cms/wordpress/post_delete · Action
Delete a post from your WordPress site. Moves it to the Trash by default; enable Permanently Delete to remove it for good.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Post ID | string | Required | 123 |
| Permanently Delete | boolean | On: delete permanently. Off (default): move to Trash. |
Returns: id, result, tool_result, success, error
WordPress: Get Post
cms/wordpress/post_get · Action
Retrieve a single post from your WordPress site by ID.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Post ID | string | Required | 123 |
| Context | string | choices: View, Edit (more fields; needs edit rights), Embed | |
| Post Password | string | Required to read a password-protected post |
Returns: id, result, tool_result, success, error
WordPress: Get Many Posts
cms/wordpress/post_get_all · Action
List posts from your WordPress site, with optional filters. Enable Return All to auto-paginate every matching post.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Context | string | choices: View, Edit (more fields; needs edit rights), Embed | |
| Return All (auto-paginate every match) | boolean | ||
| Limit (per page) | integer | 50 per page (max 100); Return All still fetches every match | |
| Page | integer | Page number to fetch (ignored when Return All is on) | |
| Search | string | ||
| Status | string | choices: Publish, Draft, Pending Review, Private, Future, Trash, Any | |
| Author (User ID) | string | ● live picker | Limit to posts by this author user ID |
| Category IDs | string | ● live picker | Comma-separated category IDs |
| Tag IDs | string | ● live picker | Comma-separated tag IDs |
| Exclude Category IDs | string | Comma-separated category IDs to exclude | |
| Exclude Tag IDs | string | Comma-separated tag IDs to exclude | |
| Slug | string | ||
| Published After | datetime | ||
| Published Before | datetime | ||
| Include IDs | string | Comma-separated post IDs to include | |
| Exclude IDs | string | Comma-separated post IDs to exclude | |
| Sticky Only | boolean | ||
| Sort Order | string | choices: Descending, Ascending | |
| Order By | string | choices: Date, Modified, ID, Title, Slug, Author, Relevance | |
| Offset | integer | Skip this many results (ignored when Return All is on) |
Returns: results, count, total, total_pages, tool_result, success, error
WordPress: Update Post
cms/wordpress/post_update · Action
Update an existing post on your WordPress site. Only the fields you set are changed; add any other post field via Additional Fields.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Post ID | string | Required | 123 |
| Title | string | ||
| Content | text | HTML or block markup | |
| Excerpt | text | ||
| Status | string | choices: Publish, Draft, Pending Review, Private, Scheduled (future) | |
| Author (User ID) | string | ● live picker | |
| Slug | string | ||
| Category IDs | string | Comma-separated category IDs (replaces the set) | |
| Tag IDs | string | Comma-separated tag IDs (replaces the set) | |
| Format | string | choices: Standard, Aside, Gallery, Link, Image, Quote, Status, Video, Audio, Chat | |
| Featured Media (ID) | string | ||
| Sticky | boolean | ||
| Post Password | string | ||
| Comments | string | choices: Open, Closed | |
| Pingbacks | string | choices: Open, Closed | |
| Date | datetime | ||
| Template | string | ||
| Meta (JSON) | object | {"my_key":"my_value"} | |
| Additional Fields (JSON) | object |
Returns: id, result, tool_result, success, error
06Tag
WordPress: Create Tag
cms/wordpress/tag_create · Action
Create a tag on your WordPress site with a name and optional description and slug, or add any other tag field via Additional Fields.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Name | string | Required | |
| Description | text | ||
| Slug | string | ||
| Meta (JSON) | object | {"my_key":"my_value"} | |
| Additional Fields (JSON) | object | {"key":"value"} |
Returns: id, result, tool_result, success, error
WordPress: Delete Tag
cms/wordpress/tag_delete · Action
Permanently delete a tag from your WordPress site by ID; taxonomy terms cannot be trashed, so this always removes it for good.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Tag ID | string | Required | 123 |
Returns: id, result, tool_result, success, error
WordPress: Get Tag
cms/wordpress/tag_get · Action
Retrieve a single tag from your WordPress site by ID.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Tag ID | string | Required | 123 |
| Context | string | choices: View, Edit (more fields; needs edit rights), Embed |
Returns: id, result, tool_result, success, error
WordPress: Get Many Tags
cms/wordpress/tag_get_all · Action
List tags from your WordPress site, with optional filters. Enable Return All to auto-paginate every matching tag.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Context | string | choices: View, Edit (more fields; needs edit rights), Embed | |
| Return All (auto-paginate every match) | boolean | ||
| Limit (per page) | integer | 50 per page (max 100); Return All still fetches every match | |
| Page | integer | Page number to fetch (ignored when Return All is on) | |
| Search | string | ||
| Assigned to Post ID | string | Limit to tags assigned to this post ID | |
| Slug | string | ||
| Hide Empty (only tags with posts) | boolean | ||
| Sort Order | string | choices: Descending, Ascending | |
| Order By | string | choices: Name, ID, Slug, Count, Description, Term Group, Include | |
| Include IDs | string | Comma-separated tag IDs to include | |
| Exclude IDs | string | Comma-separated tag IDs to exclude | |
| Offset | integer | Skip this many results (ignored when Return All is on) |
Returns: results, count, total, total_pages, tool_result, success, error
WordPress: Update Tag
cms/wordpress/tag_update · Action
Update an existing tag on your WordPress site. Only the fields you set are changed; add any other tag field via Additional Fields.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Tag ID | string | Required | 123 |
| Name | string | ||
| Description | text | ||
| Slug | string | ||
| Meta (JSON) | object | {"my_key":"my_value"} | |
| Additional Fields (JSON) | object |
Returns: id, result, tool_result, success, error
07User
WordPress: Create User
cms/wordpress/user_create · Action
Create a new user on your WordPress site. Set common fields directly (username, email, password, roles) or add any other user field via Additional Fields.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Username | string | Required | Login name for the new user |
string | Required | user@example.com | |
| Password | string | Required | Account password for the new user |
| Display Name | string | ||
| First Name | string | ||
| Last Name | string | ||
| Website URL | string | https://the-user-website.com | |
| Description | text | Biographical info shown on the profile | |
| Nickname | string | ||
| Slug | string | ||
| Roles | string | Comma-separated role slugs, e.g. author,editor | |
| Meta (JSON) | object | {"my_key":"my_value"} | |
| Additional Fields (JSON) | object | {"locale":"en_US"} |
Returns: id, result, tool_result, success, error
WordPress: Delete User
cms/wordpress/user_delete · Action
Delete a user from your WordPress site, reassigning their content to another user (required by WordPress).
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| User ID | string | Required | 123 |
| Reassign Content To (User ID) | string | Required | User ID to inherit this user's posts — WordPress requires this |
Returns: id, result, tool_result, success, error
WordPress: Get User
cms/wordpress/user_get · Action
Retrieve a single user from your WordPress site by ID.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| User ID | string | Required | 123 |
| Context | string | choices: View, Edit (more fields; needs edit rights), Embed |
Returns: id, result, tool_result, success, error
WordPress: Get Many Users
cms/wordpress/user_get_all · Action
List users from your WordPress site, with optional filters. Enable Return All to auto-paginate every matching user.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| Context | string | choices: View, Edit (more fields; needs edit rights), Embed | |
| Return All (auto-paginate every match) | boolean | ||
| Limit (per page) | integer | 50 per page (max 100); Return All still fetches every match | |
| Page | integer | Page number to fetch (ignored when Return All is on) | |
| Search | string | ||
| Roles | string | Comma-separated role slugs to filter | |
| Who | string | choices: Any, Authors Only | |
| Slug | string | ||
| Sort Order | string | choices: Descending, Ascending | |
| Order By | string | choices: Name, ID, Registered Date, Slug, Email, URL | |
| Include IDs | string | Comma-separated user IDs to include | |
| Exclude IDs | string | Comma-separated user IDs to exclude | |
| Offset | integer | Skip this many results (ignored when Return All is on) |
Returns: results, count, total, total_pages, tool_result, success, error
WordPress: Update User
cms/wordpress/user_update · Action
Update an existing user on your WordPress site. Only the fields you set are changed; add any other user field via Additional Fields.
| Field | Type | Details | |
|---|---|---|---|
| Site URL | string | Required | https://your-site.com — your WordPress site root, not the /wp-json path |
| Username | string | Required | Your WordPress username |
| User ID | string | Required | 123 |
| Display Name | string | ||
| First Name | string | ||
| Last Name | string | ||
string | user@example.com | ||
| Website URL | string | https://the-user-website.com | |
| Description | text | Biographical info shown on the profile | |
| Nickname | string | ||
| Slug | string | ||
| Password | string | Set a new account password (leave blank to keep the current one) | |
| Roles | string | Comma-separated role slugs, e.g. author,editor (replaces the set) | |
| Meta (JSON) | object | {"my_key":"my_value"} | |
| Additional Fields (JSON) | object |
Returns: id, result, tool_result, success, error
08Notes & Limitations
Behaviours and constraints worth knowing before you build with these nodes.
- Deleting a user requires nominating another user to inherit their content, as WordPress will not delete a user while their posts and pages are unassigned.
- Deleting a category or tag is always permanent — WordPress cannot move taxonomy terms to the Trash, so the Permanently Delete toggle does not apply to them.
- Deleting a post, page or comment moves it to the Trash by default; enable Permanently Delete to remove it for good.
- Authentication uses an Application Password generated in the WordPress user's profile, not the account's normal login password.
- Update actions only change the fields you set, so leaving a field blank preserves its existing value rather than clearing it.
- To assign several categories or tags at once, enter their IDs as a comma-separated list, since the live picker selects one term at a time.