---
title: "Schedule an article for publishing"
method: POST
path: "/v3/cms/schedule"
tags: ["CMS"]
---

# Schedule an article for publishing

`POST /v3/cms/schedule`

Schedule an existing SnowSEO article to publish to a connected CMS provider at a future date-time.

## Request body

- object
  - `teamId` string
  - `articleSlug` string, required
  - `provider` 'wordpress' | 'shopify' | 'webflow' | 'ghost' | 'webhook' | 'framer' | 'grigora' | 'embed', required
  - `scheduledAt` string, date-time, required
  - `cmsPostStatus` 'draft' | 'publish'

## Response `200`

Default Response

- object
  - `success` boolean
  - `message` string
  - `jobId` string

## Other responses

- `400` — Default Response
- `404` — Default Response
- `500` — Default Response

## Changes

- **2026-08-23** `78929b45c4f8` — 1 info
  - added the new `embed` enum value to the request property `provider`
- **2026-07-26** `60ff6690f93c` — 2 info
  - added the new optional request property `cmsPostStatus`
  - added the new `grigora` enum value to the request property `provider`

[Change history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/cms/schedule/post.md)

---

[API](https://skmtc.dev/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.dev/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/snowseo/snowseo-api/revisions/6add26eeb5ca/schema)