POST

Create Draft Post


Creates a draft post.

The title is optional. A missing, empty or whitespace-only title creates an untitled draft post, which is returned with an empty title. An untitled draft post can't be published or scheduled, so creating it with publish set to true fails with the POST_TITLE_REQUIRED application error.

The response includes richContent only when fieldsets contains RICH_CONTENT. The content is saved either way, so a response without richContent doesn't mean the content wasn't saved.

Each successful call creates a new draft post, even when a draft post with the same title and content already exists. To read a draft post that you created, call Get Draft Post with its id instead of creating it again.

For 3rd-party apps, memberId is a required field.

In categoryIds, only categories that already exist will be added to the draft post. Including categoryIds that do not exist will not return an error, but they will not be added to the categoryIds array. If some of the categories exist, those will be added while those that do not exist will not be added to categoryIds. You can check which categories are available with List Categories.

Permission Scopes
Manage Blog
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/blog/v3/draft-posts

Errors

This method doesn't return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Event TriggersThis method triggers the following events:
Did this help?