Create Article

Create an article (draft) from a pre-built outline

curl --request POST \
  --url https://api.snowseo.com/v3/cms/articles \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "topicId": "<string>",
  "teamId": "<string>",
  "content": "<string>",
  "type": "blog",
  "status": "draft",
  "contentArticleType": "<string>",
  "authorName": "<string>",
  "keywords": [
    {
      "keyword": "<string>"
    }
  ],
  "prompts": [
    {
      "prompt": "<string>",
      "topic": "<string>"
    }
  ],
  "metaData": {
    "metaDescription": "<string>",
    "metaTitle": "<string>",
    "ogTitle": "<string>",
    "ogDescription": "<string>",
    "twitterTitle": "<string>",
    "twitterDescription": "<string>",
    "canonicalUrl": "<string>"
  },
  "articleOutline": {},
  "internalLinkTargetSlugs": [
    "<string>"
  ],
  "internalLinkTargetUrls": [
    "<string>"
  ]
}
'

import requests

url = "https://api.snowseo.com/v3/cms/articles"

payload = {
    "title": "<string>",
    "topicId": "<string>",
    "teamId": "<string>",
    "content": "<string>",
    "type": "blog",
    "status": "draft",
    "contentArticleType": "<string>",
    "authorName": "<string>",
    "keywords": [{ "keyword": "<string>" }],
    "prompts": [
        {
            "prompt": "<string>",
            "topic": "<string>"
        }
    ],
    "metaData": {
        "metaDescription": "<string>",
        "metaTitle": "<string>",
        "ogTitle": "<string>",
        "ogDescription": "<string>",
        "twitterTitle": "<string>",
        "twitterDescription": "<string>",
        "canonicalUrl": "<string>"
    },
    "articleOutline": {},
    "internalLinkTargetSlugs": ["<string>"],
    "internalLinkTargetUrls": ["<string>"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: '<string>',
    topicId: '<string>',
    teamId: '<string>',
    content: '<string>',
    type: 'blog',
    status: 'draft',
    contentArticleType: '<string>',
    authorName: '<string>',
    keywords: [{keyword: '<string>'}],
    prompts: [{prompt: '<string>', topic: '<string>'}],
    metaData: {
      metaDescription: '<string>',
      metaTitle: '<string>',
      ogTitle: '<string>',
      ogDescription: '<string>',
      twitterTitle: '<string>',
      twitterDescription: '<string>',
      canonicalUrl: '<string>'
    },
    articleOutline: {},
    internalLinkTargetSlugs: ['<string>'],
    internalLinkTargetUrls: ['<string>']
  })
};

fetch('https://api.snowseo.com/v3/cms/articles', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.snowseo.com/v3/cms/articles",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => '<string>',
    'topicId' => '<string>',
    'teamId' => '<string>',
    'content' => '<string>',
    'type' => 'blog',
    'status' => 'draft',
    'contentArticleType' => '<string>',
    'authorName' => '<string>',
    'keywords' => [
        [
                'keyword' => '<string>'
        ]
    ],
    'prompts' => [
        [
                'prompt' => '<string>',
                'topic' => '<string>'
        ]
    ],
    'metaData' => [
        'metaDescription' => '<string>',
        'metaTitle' => '<string>',
        'ogTitle' => '<string>',
        'ogDescription' => '<string>',
        'twitterTitle' => '<string>',
        'twitterDescription' => '<string>',
        'canonicalUrl' => '<string>'
    ],
    'articleOutline' => [
        
    ],
    'internalLinkTargetSlugs' => [
        '<string>'
    ],
    'internalLinkTargetUrls' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.snowseo.com/v3/cms/articles"

	payload := strings.NewReader("{\n  \"title\": \"<string>\",\n  \"topicId\": \"<string>\",\n  \"teamId\": \"<string>\",\n  \"content\": \"<string>\",\n  \"type\": \"blog\",\n  \"status\": \"draft\",\n  \"contentArticleType\": \"<string>\",\n  \"authorName\": \"<string>\",\n  \"keywords\": [\n    {\n      \"keyword\": \"<string>\"\n    }\n  ],\n  \"prompts\": [\n    {\n      \"prompt\": \"<string>\",\n      \"topic\": \"<string>\"\n    }\n  ],\n  \"metaData\": {\n    \"metaDescription\": \"<string>\",\n    \"metaTitle\": \"<string>\",\n    \"ogTitle\": \"<string>\",\n    \"ogDescription\": \"<string>\",\n    \"twitterTitle\": \"<string>\",\n    \"twitterDescription\": \"<string>\",\n    \"canonicalUrl\": \"<string>\"\n  },\n  \"articleOutline\": {},\n  \"internalLinkTargetSlugs\": [\n    \"<string>\"\n  ],\n  \"internalLinkTargetUrls\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.snowseo.com/v3/cms/articles")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"<string>\",\n  \"topicId\": \"<string>\",\n  \"teamId\": \"<string>\",\n  \"content\": \"<string>\",\n  \"type\": \"blog\",\n  \"status\": \"draft\",\n  \"contentArticleType\": \"<string>\",\n  \"authorName\": \"<string>\",\n  \"keywords\": [\n    {\n      \"keyword\": \"<string>\"\n    }\n  ],\n  \"prompts\": [\n    {\n      \"prompt\": \"<string>\",\n      \"topic\": \"<string>\"\n    }\n  ],\n  \"metaData\": {\n    \"metaDescription\": \"<string>\",\n    \"metaTitle\": \"<string>\",\n    \"ogTitle\": \"<string>\",\n    \"ogDescription\": \"<string>\",\n    \"twitterTitle\": \"<string>\",\n    \"twitterDescription\": \"<string>\",\n    \"canonicalUrl\": \"<string>\"\n  },\n  \"articleOutline\": {},\n  \"internalLinkTargetSlugs\": [\n    \"<string>\"\n  ],\n  \"internalLinkTargetUrls\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.snowseo.com/v3/cms/articles")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"<string>\",\n  \"topicId\": \"<string>\",\n  \"teamId\": \"<string>\",\n  \"content\": \"<string>\",\n  \"type\": \"blog\",\n  \"status\": \"draft\",\n  \"contentArticleType\": \"<string>\",\n  \"authorName\": \"<string>\",\n  \"keywords\": [\n    {\n      \"keyword\": \"<string>\"\n    }\n  ],\n  \"prompts\": [\n    {\n      \"prompt\": \"<string>\",\n      \"topic\": \"<string>\"\n    }\n  ],\n  \"metaData\": {\n    \"metaDescription\": \"<string>\",\n    \"metaTitle\": \"<string>\",\n    \"ogTitle\": \"<string>\",\n    \"ogDescription\": \"<string>\",\n    \"twitterTitle\": \"<string>\",\n    \"twitterDescription\": \"<string>\",\n    \"canonicalUrl\": \"<string>\"\n  },\n  \"articleOutline\": {},\n  \"internalLinkTargetSlugs\": [\n    \"<string>\"\n  ],\n  \"internalLinkTargetUrls\": [\n    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "article": {
    "slug": "<string>",
    "teamId": "<string>",
    "title": "<string>",
    "status": "<string>",
    "type": "<string>"
  }
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

POST

cms

articles

Create an article (draft) from a pre-built outline

curl --request POST \
  --url https://api.snowseo.com/v3/cms/articles \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "topicId": "<string>",
  "teamId": "<string>",
  "content": "<string>",
  "type": "blog",
  "status": "draft",
  "contentArticleType": "<string>",
  "authorName": "<string>",
  "keywords": [
    {
      "keyword": "<string>"
    }
  ],
  "prompts": [
    {
      "prompt": "<string>",
      "topic": "<string>"
    }
  ],
  "metaData": {
    "metaDescription": "<string>",
    "metaTitle": "<string>",
    "ogTitle": "<string>",
    "ogDescription": "<string>",
    "twitterTitle": "<string>",
    "twitterDescription": "<string>",
    "canonicalUrl": "<string>"
  },
  "articleOutline": {},
  "internalLinkTargetSlugs": [
    "<string>"
  ],
  "internalLinkTargetUrls": [
    "<string>"
  ]
}
'

import requests

url = "https://api.snowseo.com/v3/cms/articles"

payload = {
    "title": "<string>",
    "topicId": "<string>",
    "teamId": "<string>",
    "content": "<string>",
    "type": "blog",
    "status": "draft",
    "contentArticleType": "<string>",
    "authorName": "<string>",
    "keywords": [{ "keyword": "<string>" }],
    "prompts": [
        {
            "prompt": "<string>",
            "topic": "<string>"
        }
    ],
    "metaData": {
        "metaDescription": "<string>",
        "metaTitle": "<string>",
        "ogTitle": "<string>",
        "ogDescription": "<string>",
        "twitterTitle": "<string>",
        "twitterDescription": "<string>",
        "canonicalUrl": "<string>"
    },
    "articleOutline": {},
    "internalLinkTargetSlugs": ["<string>"],
    "internalLinkTargetUrls": ["<string>"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: '<string>',
    topicId: '<string>',
    teamId: '<string>',
    content: '<string>',
    type: 'blog',
    status: 'draft',
    contentArticleType: '<string>',
    authorName: '<string>',
    keywords: [{keyword: '<string>'}],
    prompts: [{prompt: '<string>', topic: '<string>'}],
    metaData: {
      metaDescription: '<string>',
      metaTitle: '<string>',
      ogTitle: '<string>',
      ogDescription: '<string>',
      twitterTitle: '<string>',
      twitterDescription: '<string>',
      canonicalUrl: '<string>'
    },
    articleOutline: {},
    internalLinkTargetSlugs: ['<string>'],
    internalLinkTargetUrls: ['<string>']
  })
};

fetch('https://api.snowseo.com/v3/cms/articles', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.snowseo.com/v3/cms/articles",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => '<string>',
    'topicId' => '<string>',
    'teamId' => '<string>',
    'content' => '<string>',
    'type' => 'blog',
    'status' => 'draft',
    'contentArticleType' => '<string>',
    'authorName' => '<string>',
    'keywords' => [
        [
                'keyword' => '<string>'
        ]
    ],
    'prompts' => [
        [
                'prompt' => '<string>',
                'topic' => '<string>'
        ]
    ],
    'metaData' => [
        'metaDescription' => '<string>',
        'metaTitle' => '<string>',
        'ogTitle' => '<string>',
        'ogDescription' => '<string>',
        'twitterTitle' => '<string>',
        'twitterDescription' => '<string>',
        'canonicalUrl' => '<string>'
    ],
    'articleOutline' => [
        
    ],
    'internalLinkTargetSlugs' => [
        '<string>'
    ],
    'internalLinkTargetUrls' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.snowseo.com/v3/cms/articles"

	payload := strings.NewReader("{\n  \"title\": \"<string>\",\n  \"topicId\": \"<string>\",\n  \"teamId\": \"<string>\",\n  \"content\": \"<string>\",\n  \"type\": \"blog\",\n  \"status\": \"draft\",\n  \"contentArticleType\": \"<string>\",\n  \"authorName\": \"<string>\",\n  \"keywords\": [\n    {\n      \"keyword\": \"<string>\"\n    }\n  ],\n  \"prompts\": [\n    {\n      \"prompt\": \"<string>\",\n      \"topic\": \"<string>\"\n    }\n  ],\n  \"metaData\": {\n    \"metaDescription\": \"<string>\",\n    \"metaTitle\": \"<string>\",\n    \"ogTitle\": \"<string>\",\n    \"ogDescription\": \"<string>\",\n    \"twitterTitle\": \"<string>\",\n    \"twitterDescription\": \"<string>\",\n    \"canonicalUrl\": \"<string>\"\n  },\n  \"articleOutline\": {},\n  \"internalLinkTargetSlugs\": [\n    \"<string>\"\n  ],\n  \"internalLinkTargetUrls\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.snowseo.com/v3/cms/articles")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"<string>\",\n  \"topicId\": \"<string>\",\n  \"teamId\": \"<string>\",\n  \"content\": \"<string>\",\n  \"type\": \"blog\",\n  \"status\": \"draft\",\n  \"contentArticleType\": \"<string>\",\n  \"authorName\": \"<string>\",\n  \"keywords\": [\n    {\n      \"keyword\": \"<string>\"\n    }\n  ],\n  \"prompts\": [\n    {\n      \"prompt\": \"<string>\",\n      \"topic\": \"<string>\"\n    }\n  ],\n  \"metaData\": {\n    \"metaDescription\": \"<string>\",\n    \"metaTitle\": \"<string>\",\n    \"ogTitle\": \"<string>\",\n    \"ogDescription\": \"<string>\",\n    \"twitterTitle\": \"<string>\",\n    \"twitterDescription\": \"<string>\",\n    \"canonicalUrl\": \"<string>\"\n  },\n  \"articleOutline\": {},\n  \"internalLinkTargetSlugs\": [\n    \"<string>\"\n  ],\n  \"internalLinkTargetUrls\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.snowseo.com/v3/cms/articles")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"<string>\",\n  \"topicId\": \"<string>\",\n  \"teamId\": \"<string>\",\n  \"content\": \"<string>\",\n  \"type\": \"blog\",\n  \"status\": \"draft\",\n  \"contentArticleType\": \"<string>\",\n  \"authorName\": \"<string>\",\n  \"keywords\": [\n    {\n      \"keyword\": \"<string>\"\n    }\n  ],\n  \"prompts\": [\n    {\n      \"prompt\": \"<string>\",\n      \"topic\": \"<string>\"\n    }\n  ],\n  \"metaData\": {\n    \"metaDescription\": \"<string>\",\n    \"metaTitle\": \"<string>\",\n    \"ogTitle\": \"<string>\",\n    \"ogDescription\": \"<string>\",\n    \"twitterTitle\": \"<string>\",\n    \"twitterDescription\": \"<string>\",\n    \"canonicalUrl\": \"<string>\"\n  },\n  \"articleOutline\": {},\n  \"internalLinkTargetSlugs\": [\n    \"<string>\"\n  ],\n  \"internalLinkTargetUrls\": [\n    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "article": {
    "slug": "<string>",
    "teamId": "<string>",
    "title": "<string>",
    "status": "<string>",
    "type": "<string>"
  }
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Create a draft article. This does not generate body content — for a fully AI-written article in one step, use Generate Article. Use this when you already have an outline from Generate Outline and want manual control. Pass the outline under articleOutline, then call Start Generation with the returned slug to write the content.

A valid topicId is required — every article belongs to a topic cluster. Use Topics to find one, or Create Topic to add one. The topic name is taken from the cluster.

The optional language field sets the language code the article is written in (e.g. es). Codes are usually two letters, with three exceptions: Chinese is zh_CN or zh_TW, and Hebrew is iw (the legacy code, not he). Omit it to use your brand’s Writing Language (Settings → Content & CMS → Articles), falling back to your brand’s default language. Whichever applies is recorded on the article, so later refreshes, audits, and editor commands stay in that language even if the brand setting changes.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

title

string

required

Article title.

topicId

string

required

Required. Id of the team's topic cluster this article belongs to — get it from topic_clusters_list, or create one with create_topic_cluster. The topic name is taken from this cluster (do not pass a free-text topic).

teamId

string

Team id (falls back to the session's active project).

content

string

Optional markdown body. Leave empty for a draft you will fill via start_article_generation.

type

string

default:blog

Article type: listicle | guide | comparison | review | news (or blog for a generic post). Must match the outline's structure.

status

string

default:draft

contentArticleType

string | null

"pillar" or "cluster" for pillar/cluster content, null/omitted for generic posts.

authorName

string

keywords

object[]

Show child attributes

prompts

object[]

Show child attributes

metaData

object

Show child attributes

articleOutline

object

Outline wrapper consumed by the generator. Shape: { generateOutlineResponse: , outlineAdditionalElements: { targetWordCount:number, _shouldIncludeFAQ:boolean, _shouldIncludeTldr:boolean, _shouldIncludeConclusion:boolean, _shouldIncludeCTA:boolean }, outlineNonEditable: { introduction: { estimated_words:150 }, conclusion?: { estimated_words:150 } }, audience_level:'auto', content_tone?:string }. Do NOT hand-author the outline — obtain it from generate_outline and pass it through unchanged.

internalLinkTargetSlugs

string[]

Slugs of existing SnowSEO articles to link out to (internal links).

internalLinkTargetUrls

string[]

Absolute http(s) URLs to link out to that are not SnowSEO articles.

Response

Default Response

article

object

Show child attributes

Overview

Website Analysis

Keywords & Research

Topic Clusters

Traffic & Analytics

AI Visibility

Rank Tracking

Article Generation

Content

Content Utilities

Reports

Dashboard

Settings

Authorizations

Body

Response