---
title: Schedule API Errors - Error Codes & Messages
description: Reference for validation, authentication, and processing errors returned by the PostNitro Embed Schedule API, with HTTP status codes and error messages.
canonical: https://postnitro.ai/docs/embed/api/schedule/errors
---

# Error reference

Schedule API errors come from two layers.

## 1. Edge validation (`422`)

Request-shape checks run at the Embed API before forwarding. They return:

```json
{ "status": false, "message": "<reason>" }
```

| Message | Endpoint(s) |
| --- | --- |
| `Token is required for this call.` | all (missing key header) |
| `Extra parameters passed in the body.` | create, update |
| `Status is required` | create, update |
| `Status must be 'DRAFT' or 'SCHEDULED'` | create, update |
| `Scheduled at is required` | create, update |
| `Scheduled at must be a string` | create, update |
| `Scheduled at is not a valid date` | create, update |
| `Design id must be a string` | create, update |
| `Post content must be an object` | create, update |
| `Selected accounts must be an array` | create, update |
| `Instagram post settings must be an object` | create, update |
| `TikTok post settings must be an object` | create, update |
| `LinkedIn post settings must be an object` | create, update |
| `Threads post settings must be an object` | create, update |
| `Post settings must be an object` | create, update |
| `Post id is required` | get, update, delete |
| `From date is required` / `From date is not a valid date` | list |
| `To date is required` / `To date is not a valid date` | list |

## 2. Authentication & plan (`401` / `402`)

```json
{ "status": false, "message": "<reason>" }
```

| Status | Message |
| --- | --- |
| `401` | `Unauthorized` (no key) |
| `401` | `Unable to find embed details, please check your Embed API key and make sure to use the key for API.` |
| `401` | `Unable to find workspace details, please attach a workspace to this API key.` |
| `401` | `Unable to find organization details.` |
| `402` | `Embed API requires a paid main plan with the API Credits add-on, or an active Embed API subscription.` |

## 3. Processing / business rules (relayed from PostNitro)

These preserve the upstream status code where available (otherwise `500`):

```jsonc
{
  "success": false,
  "message": "<reason>",
  "error": { /* upstream details, or the message string */ }
}
```

### Content & ownership
- `Workspace not found.`
- `Scheduled at is required`
- `Design not found.` — `designId` set but not found in your workspace
- `Invalid post status`
- `Post content must be an object` / `Post content is empty` / `Post content must have 'common' key or at least one platform-specific key (...)`
- `Either designId or postContent must be provided. ...`
- `Selected accounts must be an array`
- `Social account(s) not found or do not belong to this workspace: <ids>`
- `Scheduled at must be a string` / `Scheduled at is not a valid date` / `Scheduled at is in the past`

### Instagram
- `Instagram post settings are required ...`
- `Instagram post type invalid`
- `Instagram post as story invalid`

### TikTok
- `TikTok post settings are required ...`
- `TikTok post type invalid`
- `TikTok who can see invalid`
- `TikTok comment invalid`
- `TikTok auto add music invalid`
- `TikTok duet invalid`
- `TikTok stitch invalid`
- `TikTok branded content invalid`
- `TikTok your brand invalid`
- `TikTok third party brand invalid`
- `TikTok AI generated content invalid`
- `You need to indicate if your Tiktok content promotes ...`
- `You can't set branded content to true when privacy level is 'Only Me'`

### LinkedIn
- `Design is required for scheduled LinkedIn posts`
- `LinkedIn post settings are required ...`
- `LinkedIn post type invalid`
- `LinkedIn post title invalid`
- `LinkedIn post title must be at least 5 character`
- `LinkedIn post title must be less than 90 characters`

### Threads
- `Threads post settings are required ...`
- `Threads post type invalid`

### Reels
- `Post settings are required for reel posts`
- `Video duration invalid`

### Persistence
- `Failed to create <status> post` (create)
- `Failed to update <status> post` (update)
- `Post details not found.` (get, update, delete — `404`)
- `Error deleting post` (delete)