Built-in tool
Save WordPress Post or Page
Create a post or page on a connected WordPress website, or change one: text, title, slug, categories, tags, featured image, SEO title and meta description. New content is a draft until you publish it.
Endpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| idnumber · optional | number | optional | The post or page to change. Leave out to create a new one. |
| seoobject · optional | object | optional | Title tag and meta description, written through the site's SEO plugin (Yoast SEO, Rank Math, All in One SEO or SEOPress). |
| sitestring · optional | string | optional | Which connected WordPress site, when several are connected: its address (example.com), its name or its account id. Leave out when only one is connected. |
| slugstring · optional | string | optional | The last part of the address: lowercase, hyphenated. Changing it on live content changes the address. |
| tagsobject · optional | object | optional | Tag names, posts only. Replaces the post's tags; a name that does not exist is created. |
| typestring · optional | string | optional | post for a blog post or article (default), page for a standing page. One of: Default: |
| titlestring · optional | string | optional | The title: it is the page's H1. Required when creating. |
| statusstring · optional | string | optional | draft: saved in WordPress, not on the site (the default for new content). publish: live at once. future: scheduled, with publishAt. pending: waiting for review. private: only signed-in editors. Leave out on an update to keep the current status. One of: |
| contentstring · optional | string | optional | The body, as HTML (headings from <h2> down, paragraphs, lists, links, images). No <h1>, no <html> or <head>. On an update this replaces the whole body: read it first with wordpress-get-content and send the edited whole. |
| excerptstring · optional | string | optional | The short summary themes show in post lists. |
| parentIdnumber · optional | number | optional | Pages only: the id of the parent page; 0 for none. |
| publishAtstring · optional | string | optional | When scheduled content goes live: ISO 8601 with its offset, for example 2026-12-01T09:00:00+01:00. Use with status future. |
| categoriesobject · optional | object | optional | Category names, posts only. Replaces the post's categories; a name that does not exist is created. |
| contentFormatstring · optional | string | optional | html (default) is stored as given. markdown is rendered to HTML first. One of: Default: |
| featuredMediaIdnumber · optional | number | optional | The featured image: a media id from wordpress-upload-media. 0 removes it. |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site",
"action",
"content",
"live",
"notes"
],
"properties": {
"seo": {
"type": "object",
"required": [
"plugin",
"pluginName",
"titleSet",
"descriptionSet"
],
"properties": {
"note": {
"type": "string"
},
"plugin": {
"enum": [
"yoast",
"rankmath",
"aioseo",
"seopress",
"none"
],
"type": "string"
},
"titleSet": {
"type": [
"boolean",
"null"
]
},
"pluginName": {
"type": "string"
},
"descriptionSet": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
},
"live": {
"type": "boolean"
},
"site": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"action": {
"enum": [
"created",
"updated"
],
"type": "string"
},
"before": {
"type": "object",
"required": [
"status",
"title",
"slug",
"url",
"modified"
],
"properties": {
"url": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"status": {
"type": "string"
},
"modified": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"content": {
"type": "object",
"required": [
"id",
"type",
"status",
"title",
"slug",
"url",
"editUrl",
"date",
"modified"
],
"properties": {
"id": {
"type": "number"
},
"url": {
"type": "string"
},
"date": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"type": {
"enum": [
"post",
"page"
],
"type": "string"
},
"title": {
"type": "string"
},
"status": {
"type": "string"
},
"editUrl": {
"type": "string"
},
"modified": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"tagsCreated": {
"type": "array",
"items": {
"type": "string"
}
},
"categoriesCreated": {
"type": "array",
"items": {
"type": "string"
}
},
"previousVersionKept": {
"type": "boolean"
}
},
"additionalProperties": false
}