Skip to content

Help

Troubleshooting

Start in Executions. Open the run and click each node to see its input and output.

Execution view — A successful manual execution of the posting workflow.

#Nothing posted

Symptom	Fix
Execution is green and very short	No row passed the gate. `status` must be exactly `approved`, `platform` must include `facebook`, `id` and `message` must be present, and `scheduled_at` must be due and parseable (include a timezone offset).
`pending_approval` never goes out	Intended. A person must set `approved`.
Schedule never fires	Publish the posting workflow. Manual runs work while it is inactive.
Only some approved rows went out	`max_posts_per_run` (default 5). The rest wait for the next run.

Symptom	Fix
Sheet or tab not found	Check `google_sheet_id`, share the Sheet with the signed-in account, and match `queue_sheet_name` exactly.
Error Log stays empty	Paste the Sheet ID on Log Error to Sheet, select the credential, publish the error handler, and set it as the posting workflow's Error workflow.
Error Handler greyed out in Settings	Publish it first. On n8n 2.47.3 the picker only offers published workflows that contain an Error Trigger.
Sign-in dies about every week	External OAuth apps still in Testing expire tokens after seven days. Reconnect, or publish the consent screen. n8n docs
`redirect_uri_mismatch`	Google Cloud must list `https://YOUR-N8N-DOMAIN/rest/oauth2-credential/callback` exactly.

The error_log tab header is time, workflow, execution_id, execution_url, failed_node, error_message. There is no error-log screenshot in this kit.

#Zernio and Facebook

Symptom	Fix
`401`	Header Auth is `Authorization` = `Bearer <key>` with a space. Recreate a lost key in the Zernio dashboard.
Image missing	Public HTTPS URL only. Unused Zernio uploads expire after 7 days unless a post used them. Facebook practical limit is about 4 MB.
No link preview card	This kit does not send the Sheet `link` field. Put the URL in the caption.
`409` identical content	Zernio rejects the same content to the same account within 24 hours.
`422` on a retry	Same `Idempotency-Key` (the row `id`) with a different body inside 24 hours. Use a new `id` if you changed the caption.
`429`	60 requests/minute on the free team tier, or 25 posts/hour/account, or Facebook's daily cap of 100. Wait for `Retry-After`.
Wrong Page	Config `zernio_account_id` is the Page's account id, not the profile id.
Stuck on `publishing`	Check the Page and the execution. If the post is live, set `posted` and paste the URL; if not, set `approved` and rerun with the same `id` if the body is unchanged.
Comments or Messenger later fail	Reconnect with `scopes=posting,comments,messaging`. Posting-only connects cannot read the inbox. The Page cannot write first in Messenger.

#AI planner

Symptom	Fix
`Unknown ai_provider`	Use `openai`, `xai`, or `openrouter`.
No new rows, log says the week is planned	`posts_per_week` is already met by rows in the next 7 days with status `draft`, `pending_approval`, `approved`, or `publishing`.
Caption without an image	Read the `error` cell. The caption is still `pending_approval` on purpose.
OpenRouter daily limit	`:free` models: 20/min, 50/day without $10 in purchased credits, 1000/day with.
Unexpected image charges	OpenRouter image models are paid. Set `image_provider = none` to skip them.