Actions17
Post → Create
AI-generatedSummary
Create a new WordPress post
Inputs
- title (required) — The title for the post
- additionalFields — Additional fields such as author, content, slug, status, categories, tags, etc.
- authorId — The ID for the author of the post
- content — The content for the post
- slug — An alphanumeric identifier for the post
- password — A password to protect access to the content and excerpt
- status — The status of the post (e.g., draft, publish)
- date — The date the post was published, in the site's timezone
- commentStatus — Whether comments are open on the post
- pingStatus — If a message should be sent to announce the post
- format — The post format (e.g., standard, image)
- sticky — Whether the post should be sticky
- categories — The categories assigned to the post
- tags — The tags assigned to the post
- excerpt — The excerpt for the post
- featuredMediaId — The ID of the featured media for the post
- acfFields — Advanced Custom Fields data as JSON
- metaFields — Custom meta fields as JSON
Output shape
a single created post record
Returns the created post object; the response includes the post ID and any requested fields.
Examples
Example 1: Create a new blog post
Title: "Hello World", Content: "My first post", Author ID: 2, Status: "publish"
Example 2: Create a scheduled post with password protection
Title: "Future Post", Date: "2025-01-01T12:00:00", Status: "future", Password: "secret"
Example 3: Create a post with ACF meta
Title: "Review", acfFields: {"rating": 5}, Status: "publish"