rest_cannot_create(401)の原因|確認する順番

PythonやGitHub Actionsから、WordPressのREST APIで記事を投稿しようとしたら、401で弾かれた。返ってきたJSONには「rest_cannot_create」。アプリケーションパスワードは合っているはずなのに、なぜ? そんな状態で止まっている方に向けた記事です。

この記事では、このエラーが何を意味しているのかと、どこから確認すればいいかの順番を書きます。僕は移住前に都内でSEをしていて、今はこのブログの投稿をPythonとGitHub Actionsで自動化しています。その作業中に、まさにこのエラーで止まりました。原因は初歩的なミスでしたが、だからこそ最初に確認してほしい項目です。

読み終わるころには、上から順に確かめていけば、どこで止まっているかを絞り込めるようになるはずです。

出ているエラーはこれですか?

REST APIで投稿(POST /wp-json/wp/v2/posts)したときに、次のような内容が返ってくるケースです。

{"code":"rest_cannot_create","message":"Sorry, you are not allowed to create posts as this user.","data":{"status":401}}

WordPressの日本語の翻訳では、このメッセージは次の文になっています(2026年11月時点)。サイトの言語を日本語にしていると、こちらで返ってくることがあります。

このユーザーとして投稿を編集する権限がありません。

英語は「create(作成)」、日本語訳は「編集する」と言葉は違いますが、同じエラーです。

結論:401なら「ログインしていない人」として扱われている

先に結論です。

  • WordPressのソースコード(2026年11月時点)では、rest_cannot_create は「このユーザーには投稿を作る権限がない」ときに返るエラーです
  • そのときのステータスは、ログインしていなければ401、ログインしていれば403と決まっています
  • つまり401なら、WordPressはあなたのリクエストを「ログインしていない人」として扱っています。権限の設定より先に、認証(ユーザー名とアプリケーションパスワード)が通っているかを疑うのが近道です

僕の場合の原因は、スクリプトに書いたユーザー名が「your_wp_username」というひな形のままだったことでした。

僕の場合:Colabでは動いたのに、GitHub Actionsでは401

最初は、Google ColabでPythonを動かして投稿していました。こちらは問題なく動いていました。

ところが、GitHub Actions(GitHubの上でプログラムを自動実行できる機能)から投稿したら、401の rest_cannot_create が返ってきました。Colabでは動いていたので、「なんで?」と混乱しました。

アプリケーションパスワードは正しいものでした。原因は、スクリプトのユーザー名の欄が your_wp_username というひな形のままだったことです。GitHub Actions用にスクリプトを新しく作り直したとき、ユーザー名の欄を書き換え忘れたのだと思います(このあたりの記憶は少しあいまいです)。ユーザー名を本来のものに直したら、下書き保存できました。

気づくまでにかかったのは30分くらいです。

401が出たときに確認する順番

ここからは、確認する順番です。1と2は僕が実際に確かめたところ、3と4は英語のフォーラムなどでよく挙げられる原因を、WordPressの公式情報(2026年11月時点)で裏を取れる範囲でまとめたものです。

1. ユーザー名が正しいか(ひな形のままになっていないか)

最初に見てほしいのがここです。とくに、次のような場面では書き換え忘れが起きやすいと思います。

  • サンプルコードやAIが書いたコードを、そのまま使っている
  • 別の環境(Colab → GitHub Actionsなど)に移すために、スクリプトを作り直した

WordPressのソースを見ると、アプリケーションパスワードで使えるユーザー名は、ログインに使うユーザー名か、登録しているメールアドレスです。ブログに表示される名前(ニックネームや表示名)ではないので、そこも確かめておきましょう。

なお、今のソースでは、登録されていないユーザー名を送ると invalid_username、パスワードが違うと incorrect_password というcodeが返る作りです。これが出ていれば、ユーザー名かパスワードの問題だと分かります。ただ、僕の記録ではひな形のユーザー名のときも rest_cannot_create でした。どちらのcodeが出ても、まずユーザー名から確認してみてください。

再発を防ぐなら、ユーザー名もパスワードと同じように、GitHub ActionsのSecrets(リポジトリに保存できる秘密の値)から読み込む形にしておくと、ひな形が残りにくくなります。

import os
import requests

WP_USER = os.environ["WP_USER"]          # ひな形を直書きしない
WP_APP_PASSWORD = os.environ["WP_APP_PASSWORD"]

if WP_USER == "your_wp_username":
    raise SystemExit("ユーザー名がひな形のままです")

r = requests.post(
    "https://example.com/wp-json/wp/v2/posts",
    auth=(WP_USER, WP_APP_PASSWORD),
    json={"title": "テスト", "status": "draft"},
)
print(r.status_code, r.text)

2. アプリケーションパスワードが正しいか

アプリケーションパスワードは、WordPressの管理画面の「ユーザー」→ プロフィール(ユーザーの編集画面)で発行するものです。ログイン用のパスワードとは別物なので、取り違えていないか確認します。

WordPressの公式ガイドによると(2026年11月時点)、表示されるパスワードの途中の空白は、あってもなくても構いません。また、初期設定ではHTTPS(SSL)のサイトで使える機能とされています。

3. そのユーザーに投稿を作る権限があるか

WordPressの公式ドキュメントによると、投稿を書いて公開できるのは管理者・編集者・投稿者です。寄稿者は書けても公開はできず、購読者は自分のプロフィールの管理だけです。自動投稿用に権限の低いユーザーを作った場合は、ここが原因のこともあります。ただし、認証が通ったうえで権限が足りない場合は、401ではなく403になるはずです。401のままなら、1・2と次の4を先に見てください。

4. Authorizationヘッダーがサーバーで落ちていないか

ユーザー名とパスワードは、HTTPの「Authorization」というヘッダーに入れて送られます。WordPressの開発者向け資料には、「CGIやFastCGIで動いている一部のサーバーでは、AuthorizationヘッダーがWordPressに渡されない」と書かれています。

WordPressが作る .htaccess の書き換えルールには、このヘッダーを引き継ぐための次の1行が入っています。.htaccess を自分で編集したことがある場合は、この行が残っているか確認してみてください。

RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

また、英語のフォーラムでは、httpからhttpsへのリダイレクト(転送)でPOSTが失敗していた可能性も指摘されていました。投稿先のURLが https:// から始まっているかも見ておきましょう。

認証が通っているかだけを確かめる方法

投稿を何度も試す前に、「そもそも認証が通っているか」だけを確かめる方法もあります。同じユーザー名とアプリケーションパスワードで、次のURLにGETでアクセスします。

https://example.com/wp-json/wp/v2/users/me

認証が通っていれば、自分のユーザー情報が返ってきます。通っていなければ、401の rest_not_logged_in になります。ここで401なら原因は1・2・4のどこか、ユーザー情報が返るのに投稿だけ失敗するなら3を疑う、という切り分けができます。

403が出る場合は、別の記事を見てください

同じ自動投稿でも、ステータスが403で、中身がWordPressのJSONではない場合は、WordPressに届く前のサーバー側で止められている可能性があります。僕はConoHa WINGで、この401の前後に次の2つにも引っかかりました。

返ってきたのが「WordPressのJSONで401」なら、この記事の順番で確認すれば大丈夫です。

まとめ

rest_cannot_create の401が出たときのポイントをまとめます。

  • 401は「ログインしていない人」として扱われているサイン。権限より先に認証を疑う
  • 最初にユーザー名。ひな形のまま・表示名を書いている、がないか確認する
  • 次にアプリケーションパスワード。ログイン用のパスワードと取り違えていないか
  • 認証が通っているかは /wp-json/wp/v2/users/me で確かめられる
  • それでもダメなら、Authorizationヘッダーやリダイレクトを疑う

「別の環境では動いていた」ときこそ、まず自分の書いた設定から見直してみてください。同じエラーで手が止まっている方の参考になればうれしいです。