Guides

Test and live

Build against test mode, then swap in a live key. The requests stay the same.

	Test key	Live key
Checks	All of them, the same errors	All of them
Publishes	Never	Bluesky today; drafts on every network
Objects	`"mode": "test"`, kept apart from your Planner	`"mode": "live"`, in your calendar
Cost	Free	1 post per account it goes out on
Connect links	Never contact Bluesky; connect a test account	Connect the real account
Webhooks	None; use Send test event	Every event

Test keys see test objects only and live keys live ones, so an id from one gives 404 not_found to the other. Both see your real connected accounts.

A test post

{
  "id": "8c1f4a52-6f0e-4d1b-9a43-2d7e5b0c9f21",
  "object": "post",
  "mode": "test",
  "status": "draft",
  "text": "Hello from the HivePost API",
  "publish_at": null,
  "brand_id": "0b6d2c1e-3f4a-4e5b-8c7d-9a1b2c3d4e5f",
  "accounts": [
    {
      "id": "8c1f4a52-6f0e-4d1b-9a43-2d7e5b0c9f21",
      "network": "bluesky",
      "status": "draft",
      "text": null,
      "published_at": null,
      "external_id": null,
      "error": null
    }
  ],
  "media": [
    {
      "id": "8c1f4a52-6f0e-4d1b-9a43-2d7e5b0c9f21",
      "status": "uploading"
    }
  ],
  "created_at": "2026-11-12T10:00:00Z"
}