Error 400: invalid_request

The body is not valid JSON, or the asset type is unknown.

What to do: Fix the request. Sending it again unchanged fails again.

Every error code

Error 401: unauthorized

The API key is missing, unknown or revoked.

What to do: Send Authorization: Bearer np_live_... with a key from Settings, API & MCP.

Every error code

Error 402: insufficient_credits

The workspace has fewer credits than the job costs. Nothing was charged.

What to do: Add credits at fix.url, or send fewer leads.

Every error code

Error 402: spend_cap_reached

The job would take this API key past its monthly credit cap. Nothing was charged.

What to do: Send fewer leads, or ask a workspace owner to raise the cap at fix.url. Caps reset on the 1st (UTC).

Every error code

Error 403: plan_required

A write (any method but GET, or an MCP tool that creates or changes something) on a workspace with no paid plan or trial with a card. Reads still work.

What to do: Show the user fix.url and stop writing. GET /workspace shows the same state in plan.

Every error code

Error 404: not_found

The id is unknown, malformed, or belongs to another workspace. Over MCP with OAuth: the workspace slug is not yours, or you are in no workspace yet.

What to do: Use an id this workspace returned. No workspace yet: create one (fix.url, or create_workspace over MCP).

Every error code

Error 409: campaign_not_eligible

The campaign_id is not active with automatic page generation on.

What to do: Leave out campaign_id, or fix the campaign at fix.url.

Every error code

Error 409: idempotency_conflict

The Idempotency-Key was used in the last 24 hours for a different request.

What to do: Use a new key for a new request. Send the exact same request to get the first job back.

Every error code

Error 409: brand_not_ready

The brand is still being read from its website.

What to do: Wait for the brand job with GET /jobs/{id}, then send the request again.

Every error code

Error 409: template_not_usable

The template call to action has no destination.

What to do: Show the user fix.url to finish the template in the app.

Every error code

Error 422: validation_failed

A field is invalid, or every lead was rejected. errors[] lists each field.

What to do: Fix the listed fields and send again.

Every error code

Error 422: too_many_leads

More than 25 leads in one job.

What to do: Split the leads into jobs of 25 and send them one at a time.

Every error code

Error 429: rate_limited

A limit was reached. The limit field says which one.

What to do: Wait the Retry-After seconds, then send the same request again.

Every error code

Error 500: internal_error

A bug on our side. It is logged with the request_id.

What to do: Retry once. If it repeats, contact support with the request_id.

Every error code

Error 503: temporarily_unavailable

The API is switched off, or a page could not be started. Any charge was refunded.

What to do: Wait the Retry-After seconds and send the same request again.

Every error code