{"openapi":"3.1.0","info":{"title":"NeuroPage API","version":"1.0.0","summary":"Personalized outbound landing pages for B2B leads, from a LinkedIn URL.","description":"NeuroPage makes a personalized outbound landing page for every B2B lead you give it, from nothing more than their LinkedIn profile URL. Each page is written about that lead's company and role, styled in your brand, and hosted at a permanent URL you can paste into Instantly, HeyReach, Lemlist or any sequence. Afterwards you can see who opened their page, how far they scrolled, and who clicked or booked.\n\nYou can use it two ways: from an AI agent such as claude.ai, Claude Code, Claude Desktop or Cursor through our MCP server, or from code and tools like Clay, n8n and Make through this REST API. Agents can sign in with your NeuroPage account or use an API key; the REST API uses an API key. Both use the same objects.\n\n**Fastest start, claude.ai:** in claude.ai, open **Settings, Connectors, Add custom connector**, paste `https://neuropage.io/api/mcp` and sign in with your NeuroPage account. No key needed. Details under claude.ai and Claude Desktop below.\n\n## 1. Get your API key\n\n1. Open the app and go to **Settings, API & MCP** (`https://neuropage.io/home/{workspace}/settings/api`).\n2. Click **Create key**, give it a name, and copy the key. It starts with `np_live_` and is shown once.\n\nGood to know:\n\n- One key belongs to one workspace, and one workspace is one client. An agency makes one key per client workspace.\n- Workspaces are created in the app at `https://neuropage.io/home`. Signed in to the MCP server with your NeuroPage account (OAuth), an agent can also create one with `create_workspace`.\n- Reading works on any workspace. Changing anything (creating or editing brands, generating pages) needs a paid plan or a trial with a card on file; without one those calls return `403 plan_required` with the billing link, and `GET /workspace` shows it in `plan`.\n- Treat the key like a password. Anyone with it can spend the workspace's credits.\n- Give a key a monthly credit cap when you create it (or later). A job that would pass the cap is refused with `402 spend_cap_reached`.\n\n## 2. Connect your AI agent\n\nThe MCP server is at `https://neuropage.io/api/mcp` (Streamable HTTP). Sign in with your NeuroPage account (OAuth), or send an API key in the `Authorization` header.\n\n### claude.ai and Claude Desktop\n\n1. Open **Settings, Connectors** and click **Add custom connector**.\n2. Name it NeuroPage and paste `https://neuropage.io/api/mcp` as the URL.\n3. Click **Connect**, sign in to NeuroPage, and click **Allow**.\n\nThe connector acts as you, in every workspace you belong to. If you are in several (an agency with a workspace per client), Claude asks which client each request is for. You can disconnect it any time under **Settings, API & MCP**.\n\n### Claude Code\n\nSign in with your NeuroPage account: add the server without a key, then run `/mcp` in Claude Code and choose NeuroPage to sign in.\n\n```bash\nclaude mcp add --transport http neuropage https://neuropage.io/api/mcp\n```\n\nOr use an API key, which is pinned to one workspace:\n\nRun this once in your terminal, with your key:\n\n```bash\nclaude mcp add --transport http neuropage https://neuropage.io/api/mcp --header \"Authorization: Bearer np_live_YOUR_KEY\"\n```\n\nTo share the setup with your team without sharing the key, put this in `.mcp.json` at the root of the project and set `NEUROPAGE_API_KEY` in each person's environment:\n\n```json\n{\n  \"mcpServers\": {\n    \"neuropage\": {\n      \"type\": \"http\",\n      \"url\": \"https://neuropage.io/api/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ${NEUROPAGE_API_KEY}\"\n      }\n    }\n  }\n}\n```\n\n### Claude Desktop with an API key\n\nIf you prefer a key to signing in, open **Settings, Developer, Edit Config** and add NeuroPage to `claude_desktop_config.json`, then restart Claude Desktop. This needs Node.js on your computer, because `mcp-remote` runs through `npx`.\n\n```json\n{\n  \"mcpServers\": {\n    \"neuropage\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"mcp-remote@latest\",\n        \"https://neuropage.io/api/mcp\",\n        \"--header\",\n        \"Authorization:${AUTH_HEADER}\"\n      ],\n      \"env\": {\n        \"AUTH_HEADER\": \"Bearer np_live_YOUR_KEY\"\n      }\n    }\n  }\n}\n```\n\nThe header is written as `Authorization:${AUTH_HEADER}` with no space on purpose: Claude Desktop on Windows splits arguments on spaces, so the space lives in the `env` value instead.\n\n### ChatGPT\n\nCustom connectors in the ChatGPT app need Developer mode, which depends on your ChatGPT plan and workspace settings, and the menu names can change:\n\n1. In ChatGPT, open **Settings**, find **Apps & Connectors**, and turn on **Developer mode** under the advanced settings.\n2. Create a connector named NeuroPage with `https://neuropage.io/api/mcp` as the MCP server URL.\n3. Choose **OAuth** as the authentication, sign in to NeuroPage, and click **Allow**.\n\nThe connector acts as you, like the claude.ai connector. No API key is needed.\n\n### OpenAI API\n\nIn the Responses API, add NeuroPage as a remote MCP tool and send your key in `headers`. Here the read tools run on their own and anything that writes or spends credits comes back as an approval request first:\n\n```js\nimport OpenAI from \"openai\";\n\nconst client = new OpenAI();\n\nconst response = await client.responses.create({\n  model: \"gpt-5\",\n  tools: [\n    {\n      type: \"mcp\",\n      server_label: \"neuropage\",\n      server_url: \"https://neuropage.io/api/mcp\",\n      headers: { Authorization: \"Bearer np_live_YOUR_KEY\" },\n      // Reads run on their own; anything that writes or spends credits\n      // comes back as an approval request first.\n      require_approval: { never: { tool_names: [\"list_workspaces\", \"get_workspace\", \"list_brands\", \"get_brand\", \"list_templates\", \"get_template\", \"get_job\", \"list_assets\", \"get_asset_stats\", \"get_company_profile\", \"list_media\", \"list_campaigns\", \"list_event_subscriptions\", \"get_campaign\", \"list_leads\", \"list_columns\", \"check_variables\", \"list_instantly_campaigns\"] } },\n    },\n  ],\n  input: \"Check my NeuroPage workspace and tell me what is missing.\",\n});\n\nconsole.log(response.output_text);\n```\n\nFor Codex, OpenAI's coding agent, keep the key in an environment variable:\n\n```bash\nexport NEUROPAGE_API_KEY=np_live_YOUR_KEY\ncodex mcp add neuropage --url https://neuropage.io/api/mcp --bearer-token-env-var NEUROPAGE_API_KEY\n```\n\n### Cursor\n\n[Add NeuroPage to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=neuropage&config=eyJ1cmwiOiJodHRwczovL25ldXJvcGFnZS5pby9hcGkvbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyIG5wX2xpdmVfWU9VUl9LRVkifX0%3D). After it opens, replace `np_live_YOUR_KEY` with your key in Cursor's MCP settings.\n\nOr add it to `~/.cursor/mcp.json` yourself:\n\n```json\n{\n  \"mcpServers\": {\n    \"neuropage\": {\n      \"url\": \"https://neuropage.io/api/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer np_live_YOUR_KEY\"\n      }\n    }\n  }\n}\n```\n\n### Grok\n\nThe Grok command-line tool adds the server the same way as Claude Code. Run this once, with your key:\n\n```bash\ngrok mcp add --transport http neuropage https://neuropage.io/api/mcp --header \"Authorization: Bearer np_live_YOUR_KEY\"\n```\n\n### VS Code\n\nAdd this to `.vscode/mcp.json`. VS Code asks for the key once and stores it securely.\n\n```json\n{\n  \"inputs\": [\n    {\n      \"type\": \"promptString\",\n      \"id\": \"neuropage-key\",\n      \"description\": \"NeuroPage API key\",\n      \"password\": true\n    }\n  ],\n  \"servers\": {\n    \"neuropage\": {\n      \"type\": \"http\",\n      \"url\": \"https://neuropage.io/api/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ${input:neuropage-key}\"\n      }\n    }\n  }\n}\n```\n\n### Clay, n8n, Make and scripts\n\nUse the REST API below with the header `Authorization: Bearer np_live_YOUR_KEY`.\n\n## 3. Try it\n\nAsk your agent, in this order:\n\n1. \"Set up a NeuroPage brand from acme.com and show me the logo and colours it found.\"\n2. \"Make NeuroPage landing pages for these 3 LinkedIn profiles with that brand: <3 profile URLs>.\"\n3. \"Which of those leads have viewed their page?\"\n\nThe agent checks your workspace, tells you what the pages will cost before it spends anything, waits for the pages, and gives you a table of leads and page URLs.\n\n## REST quickstart\n\nCheck the key and see your credits, brands and templates:\n\n```bash\ncurl https://neuropage.io/api/v1/workspace -H \"Authorization: Bearer np_live_YOUR_KEY\"\n```\n\nMake pages for 3 leads. Only `linkedin_url` is required; a name and company make nicer page URLs.\n\n```bash\ncurl -X POST https://neuropage.io/api/v1/jobs \\\n  -H \"Authorization: Bearer np_live_YOUR_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: my-first-job\" \\\n  -d '{\n    \"type\": \"landing_page\",\n    \"leads\": [\n      { \"linkedin_url\": \"https://www.linkedin.com/in/jane-doe\", \"first_name\": \"Jane\", \"last_name\": \"Doe\", \"company\": \"Acme\", \"external_ref\": \"row-1\" },\n      { \"linkedin_url\": \"https://www.linkedin.com/in/john-roe\", \"external_ref\": \"row-2\" },\n      { \"linkedin_url\": \"https://www.linkedin.com/in/ana-lima\", \"external_ref\": \"row-3\" }\n    ]\n  }'\n```\n\nThe answer is a job with status `running`. Wait for it (the call returns as soon as something changes, or after 50 seconds):\n\n```bash\ncurl \"https://neuropage.io/api/v1/jobs/job_...?wait=50\" -H \"Authorization: Bearer np_live_YOUR_KEY\"\n```\n\nWhen the status is `completed`, list the pages:\n\n```bash\ncurl \"https://neuropage.io/api/v1/assets?job_id=job_...\" -H \"Authorization: Bearer np_live_YOUR_KEY\"\n```\n\nA few pages take about 1.5 to 3 minutes. 25 take longer.\n\n## Concepts\n\n- **Workspace.** The client the key belongs to. Its company description is what every page says about \"us\". Keep one workspace per client.\n- **Brand = look; template = layout.** A brand is the logo, colours and fonts. A template is the sections and call to action. Pass optional `brand_id` and `template_id` on a job; the job's brand overrides the template's own brand.\n- **Brand.** The look: logo, colours and fonts. Make one from a website with `POST /brands` and pass its `brand_id` on a job.\n- **Template.** The layout: sections and call to action. Make one with `POST /templates` (built-in sections, a call to action, optionally a `brand_id`), list them with `GET /templates`, and pass `template_id` on a job. Custom blocks, proof, pricing and the visual editor are in the app (`edit_url` on each template).\n- **App and API.** In the NeuroPage app, a template owns its look (there is no separate Brand profiles page any more). The API keeps `brand` (`brd_`) and `template` (`tpl_`) separate, so you can reuse one look across layouts or change it per job.\n- **Job.** One request to make assets, or to read a brand from a website. Jobs are asynchronous.\n- **Asset.** One thing made for one lead. Today the only `type` is `landing_page`: a hosted page at a permanent URL that does not expire.\n\n### Waiting for results\n\nEvery job and asset has a `status`. Call `GET /jobs/{id}?wait=50` or `GET /assets/{id}?wait=50`: the call returns early when anything changes. Between calls, wait `poll_after_seconds`. Never start a job again to check on it. To be told instead of asking, see Webhooks below: they are set up in the app, not through the API.\n\nJob statuses: `running`, `completed`, `completed_with_errors`, `failed`. Asset statuses: `queued`, `processing`, `ready`, `failed`, `canceled`.\n\n### Sending the same thing twice\n\n- **Per lead, always.** A LinkedIn URL that already has a page in the same campaign (queued, processing or ready) comes back as `reused: true` and costs nothing. A failed one is tried again and charged again.\n- **Per job, optional.** Send an `Idempotency-Key` header (MCP: `idempotency_key`). The same key within 24 hours returns the first job with status 200 instead of starting a new one. Reusing the key for a different request is `409 idempotency_conflict`.\n\n### Credits\n\n`cost_per_asset` (from `GET /workspace` or the template) is the most one new page costs. A lead whose LinkedIn profile NeuroPage has already read costs only the page, and a reused page costs nothing. A job is quoted lead by lead before anything starts, and each page is charged exactly its quote. If the workspace has fewer credits, the job is refused with `402` and nothing is charged. Every job shows `cost.quoted`, `cost.charged`, `cost.refunded` and `credits_remaining`.\n\nTo see the quote without starting anything, send `POST /jobs` with `dry_run: true` (MCP: `dry_run` on `generate_assets`). It answers `200` with a `JobQuote`: `credits_quoted`, `leads_accepted` (new pages), `leads_reused`, `leads_rejected`, `credits_remaining` and `enough_credits`. No job, no charge.\n\nIn a campaign that runs research columns, a new lead's quote includes them. Research is charged when it runs, a minute or so after the job starts, and a column that finds nothing is refunded then. Pages that fail later are refunded too: `GET /jobs/{id}` shows it in `refunded`, `credits_refunded` and `refund_message`.\n\n### Limits\n\n| Limit | Value | Error |\n|---|---|---|\n| Requests per key (or per signed-in user) | 60 per minute | `429`, `limit: requests` |\n| Credits per key | The key's monthly cap, if set | `402 spend_cap_reached` |\n| Leads per job | 25 | `422 too_many_leads` |\n| Running page jobs per workspace | 2 | `429`, `limit: running_jobs` |\n| New pages per workspace | 200 per hour, 1,000 per day | `429`, `limit: assets_hour` or `assets_day` |\n\nEvery `429` has a `Retry-After` header. Every response after the key is checked also carries `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset` (seconds), so a client can slow down before it is refused. Credits are the hard limit on spend.\n\n### Accepted, then started\n\n`POST /jobs` charges and starts every page before it answers, usually in a few seconds. A page that cannot start shows up in `rejected` with `temporarily_unavailable` (or `insufficient_credits`), and anything it was charged is refunded before the answer: the same response says so in `refunded: true`, `credits_refunded` (also per lead in `rejected[].credits_refunded`) and `refund_message`.\n\nA LinkedIn URL must be a personal `linkedin.com/in/` profile. Anything else (a company page, a post, a search, an old `linkedin.com/pub/` address) is rejected before anything is charged: in `rejected` with `invalid_linkedin_url`, or as `422 validation_failed` when no lead in the job is valid.\n\n### Ids\n\nIds have a prefix that says what they are: `brd_` brand, `tpl_` template, `cmp_` campaign, `job_` job, `ast_` asset. An id from another workspace is a `404`, the same as an id that does not exist.\n\n### Errors\n\nErrors are `application/problem+json` with a stable `code`, a human `detail`, a `request_id`, and when there is one, a `hint` (the next step, in one sentence) and a `fix` (`{ \"url\" }` to show the user, or `{ \"tool\" }` to call). Every response has a `Request-Id` header.\n\nThe `type` is `https://neuropage.io/about/documentation/api#<code>`, which opens that code's entry below.\n\n#### invalid_request\n\n**400.** The body is not valid JSON, or the asset type is unknown. **What to do:** Fix the request. Sending it again unchanged fails again.\n\n#### unauthorized\n\n**401.** The API key is missing, unknown or revoked. **What to do:** Send Authorization: Bearer np_live_... with a key from Settings, API & MCP.\n\n#### insufficient_credits\n\n**402.** The workspace has fewer credits than the job costs. Nothing was charged. **What to do:** Add credits at fix.url, or send fewer leads.\n\n#### spend_cap_reached\n\n**402.** 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).\n\n#### plan_required\n\n**403.** 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.\n\n#### not_found\n\n**404.** 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).\n\n#### campaign_not_eligible\n\n**409.** 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.\n\n#### idempotency_conflict\n\n**409.** 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.\n\n#### brand_not_ready\n\n**409.** 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.\n\n#### template_not_usable\n\n**409.** The template call to action has no destination. **What to do:** Show the user fix.url to finish the template in the app.\n\n#### validation_failed\n\n**422.** A field is invalid, or every lead was rejected. errors[] lists each field. **What to do:** Fix the listed fields and send again.\n\n#### too_many_leads\n\n**422.** More than 25 leads in one job. **What to do:** Split the leads into jobs of 25 and send them one at a time.\n\n#### rate_limited\n\n**429.** A limit was reached. The limit field says which one. **What to do:** Wait the Retry-After seconds, then send the same request again.\n\n#### internal_error\n\n**500.** 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.\n\n#### temporarily_unavailable\n\n**503.** 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.\n\n## Webhooks\n\nNeuroPage can `POST` to your URL when a landing page is hosted (`page.ready`), when an API or MCP job fails with no ready pages (`job.failed`), when a campaign sends a ready lead (`lead.ready`), and when the lead views the page, clicks, fills in the form or books a meeting.\n\n**There is no REST `/webhooks` endpoint.** Subscriptions are created in two ways:\n\n1. **MCP.** `subscribe_events` registers an `https` callback (defaults to `page.ready` and `job.failed`) and returns a `signing_secret` once. `list_event_subscriptions` and `unsubscribe_events` manage those subscriptions. Writes need a live plan, like other MCP writes.\n2. **The app.** Open **Integrations, Webhooks** (`https://neuropage.io/home/{workspace}/integrations`) to add a webhook for `lead.ready` or landing-page activity. Those webhooks are not listed or removed through MCP.\n\nYou can still **poll**: `GET /jobs/{id}?wait=50` (MCP: `get_job`) returns as soon as anything changes, and is how to read the pages themselves.\n\n`page.ready` and `job.failed` fire for every campaign in the workspace, including the API campaign, with no Send-stage setup. Activity events (`page.viewed`, `cta.clicked`, `form.submitted`, `meeting.booked`) do the same. `lead.ready` still needs a campaign whose **Autopilot, Send** stage uses the webhook.\n\n### Set one up\n\n1. Open **Integrations, Webhooks** in the app (`https://neuropage.io/home/{workspace}/integrations`) and add a webhook: a name, an `https` URL, the events it takes, and optionally an auth header (name and value). The URL and header value are stored encrypted.\n2. Click **Send test** to post a sample of each event, and **Activity** to see every delivery: the body sent, your status code and the first 500 characters of your answer.\n3. For `lead.ready`: open the campaign, then **Autopilot, Send**. Pick **Webhook** as the tool, pick the webhook, and arm the stage. The campaign must be active with automatic page generation on before the API can add leads to it (`409 campaign_not_eligible` otherwise).\n\n### Events\n\n- **`lead.ready`.** A lead's page is ready and its campaign sends the lead to this webhook: the campaign's **Autopilot, Send** stage uses the tool **Webhook** with this webhook picked, and the stage is armed. NeuroPage first waits for everything the stage requires (the page, and email or LinkedIn messages when picked). A manual send from the campaign sends it too. Once per lead: a lead already sent is skipped unless you send it again from the campaign. A paused campaign sends nothing.\n- **`page.ready`.** A lead's landing page is hosted and has a permanent URL. Every campaign in the workspace, including pages made through the API or MCP. No Send-stage setup is required. Sent once per lead; a later successful delivery is not repeated.\n- **`job.failed`.** An API or MCP asset job ended with no ready pages (every accepted lead failed or was canceled). Not sent when the job is completed_with_errors. Sent once per job. The body is job-level: `job_id`, `error`, `failed_lead_ids`. Brand-from-website jobs are not included yet.\n- **`page.viewed`.** The lead starts a new visit to their page. Your own previews from the app do not count. Every campaign in the workspace, the API campaign included.\n- **`cta.clicked`.** The lead clicks the page's call to action. Every campaign in the workspace.\n- **`form.submitted`.** The lead submits the form on their page. Carries `visitor_name` and `visitor_email` when given. Every campaign in the workspace.\n- **`meeting.booked`.** The lead books a meeting through the Calendly or Cal.com embed on their page. Carries `provider` and `scheduled_at`. Every campaign in the workspace.\n\nThe payloads are under **Webhook events** in this reference (`webhooks` in `openapi.json`).\n\n### Payload\n\nOne flat JSON object, so Clay, Zapier and Make map each key to a column. Every event has `event`, `sent_at`, `lead_id`, `campaign_id`, `campaign_name`, the contact (`first_name`, `last_name`, `email`, `linkedin_url`, `company`, `job_title`, `company_domain`), `page_url` and `source_fields`. `lead.ready` adds the messages the campaign wrote: `email_subject_step_N`, `email_opening_step_N`, `email_body_step_N`, `li_connection_note`, `li_message_N`. Empty steps are left out.\n\n`lead_id` and `campaign_id` are uuids. The API ids are the same uuids with a prefix and no dashes: `ast_` + `lead_id` is the asset, `cmp_` + `campaign_id` is the campaign. To match a webhook to the row you sent, use that asset id or `linkedin_url`; `external_ref` is not in the webhook (it stays on the job's assets).\n\n### Delivery, auth and retries\n\n- **Request.** NeuroPage sends `POST` with `Content-Type: application/json`, `User-Agent: NeuroPage-Webhooks/1.0` and, when set, your auth header. When the webhook has a signing secret (MCP subscriptions always do), it also sends `X-NeuroPage-Signature: t=<unix>,v1=<hex>`, where v1 is hex HMAC-SHA256 of `${t}.${body}` with the signing secret. App-created webhooks stay unsigned unless a signing secret was stored. Answer with any 2xx within 15 seconds; redirects are not followed.\n- **Auth.** Requests are not signed (no HMAC). To make sure a request is from NeuroPage, set an auth header on the webhook (for example `Authorization: Bearer <a long random secret>`) and check it in your receiver. Use `https` only; private, loopback and link-local addresses are refused, when the webhook is saved and again before every delivery.\n- **Retries.** For `lead.ready`, a timeout, network error, `408`, `429` or `5xx` puts the send back on NeuroPage's job queue. The queue retries about every 30 seconds, but a lead's send is locked for 2 minutes after each attempt, so expect one or two more real attempts within a few minutes, not a long schedule. Any other answer (`4xx`, a redirect) is final. Activity events are sent once and not retried.\n- **After a failure.** The campaign shows the lead's send as failed; send it again from the campaign. Webhooks are best effort: if you need every page, also poll the job or list the campaign's assets (`GET /assets?campaign_id=cmp_...`).\n- **Order and duplicates.** Events are not ordered, and a retry can repeat one. Key your receiver on `lead_id` plus `event`.\n\n### Example: what your receiver gets\n\nThis is the request NeuroPage sends for `lead.ready` (the **Send test** sample), as curl, so you can point it at your own endpoint to test it:\n\n```bash\ncurl -X POST https://your-receiver.example.com/neuropage \\\n  -H \"Content-Type: application/json\" \\\n  -H \"User-Agent: NeuroPage-Webhooks/1.0\" \\\n  -H \"Authorization: Bearer <the auth header value you set>\" \\\n  -d '{\"event\":\"lead.ready\",\"sent_at\":\"2026-01-01T00:00:00.000Z\",\"lead_id\":\"00000000-0000-0000-0000-000000000000\",\"campaign_id\":\"00000000-0000-0000-0000-000000000000\",\"campaign_name\":\"Test campaign\",\"first_name\":\"Ada\",\"last_name\":\"Lovelace\",\"email\":\"ada@example.com\",\"linkedin_url\":\"https://www.linkedin.com/in/ada-lovelace\",\"company\":\"Analytical Engines\",\"job_title\":\"Head of Growth\",\"company_domain\":\"example.com\",\"page_url\":\"https://pages.neuropage.io/example/ada-lovelace\",\"email_subject_step_1\":\"A page we made for Analytical Engines\",\"email_opening_step_1\":\"Ada, I put together a short page on how you could ...\",\"li_connection_note\":\"Hi Ada, made something for you ...\",\"li_message_1\":\"Here is the page I mentioned ...\",\"source_fields\":{\"row_id\":\"r_123\"}}'\n```\n\nAnd the job that makes such a page, sent into a campaign whose Send stage is your webhook:\n\n```bash\ncurl -X POST https://neuropage.io/api/v1/jobs \\\n  -H \"Authorization: Bearer np_live_YOUR_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"type\": \"landing_page\",\n    \"campaign_id\": \"cmp_...\",\n    \"leads\": [{ \"linkedin_url\": \"https://www.linkedin.com/in/jane-doe\", \"external_ref\": \"row-1\" }]\n  }'\n```\n\n### Recipe: Clay\n\nSend rows from Clay to NeuroPage and get each page URL back in a Clay table, without polling.\n\n1. **Receive.** In Clay, make a table with a webhook as its source and copy the webhook URL Clay gives you.\n2. **Register it.** In NeuroPage, add that URL under **Integrations, Webhooks** with the event **Lead ready**. If your Clay webhook expects an auth header, put its name and value on the NeuroPage webhook. Click **Send test**: a sample row with `page_url`, `first_name`, `company`, `email_subject_step_1` and the other keys appears in Clay, one column per key.\n3. **Campaign.** Make a campaign for these leads, set its **Autopilot, Send** stage to **Webhook** with that webhook, and arm it. Its API id is `cmp_` plus the uuid at the end of the campaign's URL in the app, without dashes.\n4. **Send.** In the Clay table that holds your leads, add an HTTP API column: `POST https://neuropage.io/api/v1/jobs`, header `Authorization: Bearer np_live_YOUR_KEY`, body `{\"type\":\"landing_page\",\"campaign_id\":\"cmp_...\",\"leads\":[{\"linkedin_url\":\"<LinkedIn column>\",\"first_name\":\"<First name>\",\"company\":\"<Company>\"}]}`. One row is one lead, so one job per row.\n5. **Match.** Each `lead.ready` row in the receiving table carries `linkedin_url` and `page_url`; look rows up by `linkedin_url` to bring `page_url` and the message columns back next to your leads.\n\nMind the limits: 25 leads per job and 2 running page jobs per workspace, so for a large table, space the requests out; a `429` has a `Retry-After` header.\n\n## MCP tools\n\n| Tool | What it does |\n|---|---|\n| `list_workspaces` | The workspaces you can use. Signed in with OAuth, pass one as `workspace` on the other tools. Call it first. |\n| `create_workspace` | Signed in with OAuth only: a new workspace with you as owner. It is read-only until you start a plan in the app. Only the first workspace you create starts with 250 credits; every later one starts at 0, even if the first was deleted or handed to someone else. A workspace someone handed to you does not count as your first. At most 3 a day. |\n| `get_workspace` | Credits, brands, templates, what is still missing, and how far the setup is. |\n| `list_brands` | The workspace's brands. |\n| `get_brand` | One brand: logo, colours, fonts. |\n| `create_brand_from_website` | Create a brand (logo, colours, fonts) by reading a company website. |\n| `update_brand` | Fix a brand's name, logo, colours or fonts. |\n| `list_templates` | The workspace's templates (the layout), with sections, call to action, cost per page and `edit_url`. |\n| `get_template` | One template: sections, call to action, its own brand, the writing instruction per section, the Settings switches and the pinned images. |\n| `create_template` | Create a template (the layout) from built-in sections and a call to action, optionally linked to a brand. |\n| `generate_assets` | Make a personalized landing page for each of 1 to 25 leads. `dry_run` returns the cost first. Spends credits. |\n| `get_job` | A job's status and its pages, waiting up to 50 seconds for a change. |\n| `list_assets` | Every page in a job or campaign. |\n| `get_asset_stats` | Who viewed their page: visits, scroll depth, CTA clicks, forms, meetings. |\n\nThe tools below run a whole campaign from a chat. They are MCP only for now.\n\n| Tool | What it does |\n|---|---|\n| `get_company_profile` | The company profile and tone of voice every page and message is written from. |\n| `propose_company_profile_update` | Step 1 of changing them: your wording, rewritten into clear guidance, shown before and after. Saves nothing. |\n| `apply_company_profile_update` | Step 2: save a proposal the user agreed to. |\n| `update_template` | Change a template's name, sections, call to action, the instruction per section and the Settings switches. |\n| `set_section_images` | Pin the images or video a template section shows, each with a focus point. |\n| `upload_media` | Add an image or video to the library from a URL or from the bytes. |\n| `create_media_upload` | A one-time upload URL for a big local file. |\n| `complete_media_upload` | Record a file uploaded that way. |\n| `list_media` | The workspace's library. |\n| `delete_media` | Remove a file from the library. |\n| `list_campaigns` | The workspace's campaigns. |\n| `get_campaign` | One campaign and how far its leads are. |\n| `create_campaign` | Create a campaign. `dry_run` returns every setting first, to confirm. |\n| `update_campaign` | Change campaign settings. Returns what changed. |\n| `import_leads` | Add up to 500 leads a call, with values for any columns. Analysis costs 1 credit a new lead. |\n| `list_leads` | The lead table: status, page URL, column values, and the messages when asked. Also the export. |\n| `list_columns` | A campaign's columns, and the research that can be added with its price. |\n| `create_column` | Add a data, research or custom prompt column. |\n| `set_cell_values` | Write values per lead and column from outside, like a CSV import. Free. |\n| `run_research` | Run research columns. `dry_run` returns the cost first. Spends credits. |\n| `check_variables` | Which `{{variables}}` in the template and message prompts have a column, which have none, and which columns nothing uses. |\n| `generate_pages` | Build pages for leads in a campaign: 3 leads first, then all. 2 credits a page. |\n| `update_message_settings` | Switch the email or LinkedIn sequence on or off and steer it. |\n| `generate_messages` | NeuroPage writes the emails and LinkedIn messages. 0.5 credits a lead. |\n| `set_messages` | Save emails or LinkedIn messages written by your own AI. Free. |\n| `list_instantly_campaigns` | The campaigns of the workspace's Instantly account. |\n| `import_from_instantly` | Pull an Instantly campaign or list into a campaign, in the background. |\n| `send_to_instantly` | Add leads to an Instantly campaign with their page URL and emails. |\n\nEvery tool except `list_workspaces` and `create_workspace` takes an optional `workspace` (a slug from `list_workspaces`). With an API key it is always the key's own workspace.\n\nThe read tools (`readOnlyHint`) work on a workspace without a plan and say so in their result. The others return `plan_required` until the workspace has one.\n\n## Sandbox\n\nA sandbox key starts with `np_test_` and works on one shared demo workspace only, with low limits. It is for trying the API without a plan. To get one, [Contact us for sandbox access](https://neuropage.io/contact).\n\n| Limit | Sandbox value |\n|---|---|\n| Requests per key | 10 per minute |\n| Credits per key | 30 per month |\n| New pages in the sandbox | 10 per day, 1 job at a time |\n\nEvery sandbox response carries the header `NeuroPage-Sandbox: true`, and `GET /workspace` says `sandbox: true`. Other developers use the same workspace and can see what is in it, so do not send real lead data. A sandbox key never works on your own workspace.\n"},"servers":[{"url":"https://neuropage.io/api/v1","description":"NeuroPage"}],"security":[{"apiKey":[]}],"tags":[{"name":"Workspace","description":"Who the key acts for: credits, brands, templates, and what is missing."},{"name":"Brands","description":"The look of a page: logo, colours, fonts. Make one from a website, then fix it if needed."},{"name":"Templates","description":"The layout of a page: sections and call to action. Made here or in the app, passed as template_id. Custom blocks, proof and pricing are edited in the app (each template has an edit_url)."},{"name":"Jobs","description":"Start work and follow it. Page jobs make one asset per lead; brand jobs read a website."},{"name":"Assets","description":"What a job made: one landing page per lead, with its URL and status."},{"name":"Stats","description":"Who opened their page: visits, scroll depth, CTA clicks, forms, meetings."},{"name":"Webhook events","description":"What NeuroPage POSTs to your URL when a lead is ready or acts on their page. Webhooks are added in the app under Integrations, Webhooks; there is no API endpoint or MCP tool to register one yet. API jobs reach a webhook through a campaign_id whose Send stage uses it."}],"x-tagGroups":[{"name":"Getting started","tags":["Workspace"]},{"name":"Resources","tags":["Brands","Templates","Jobs","Assets","Stats"]},{"name":"Webhooks","tags":["Webhook events"]}],"paths":{"/workspace":{"get":{"operationId":"getWorkspace","summary":"Get the workspace","description":"Call this first. It checks the key and returns credits, brands, templates, the cost per page, a `missing` list of what to set up before pages look right, and `plan`: whether writes are allowed. It works without a plan.","tags":["Workspace"],"responses":{"200":{"description":"The workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Workspace"},"example":{"object":"workspace","slug":"acme","name":"Acme","app_url":"https://neuropage.io/home/acme","credits":{"remaining":4970,"currency":"credits"},"cost_per_asset":3,"company":{"description":"Acme builds scheduling software for field service teams.","website":"https://acme.com"},"brands":[{"id":"brd_c91200b9c0034964bad543c932f2853d","name":"acme.com","website":"https://acme.com","is_default":true}],"templates":[{"id":"tpl_568c6ef294b649bebed2353fffe98920","name":"Founder page"}],"missing":[],"setup":[{"step":"company","done":true,"tool":"get_company_profile"},{"step":"brand","done":true,"tool":"create_brand_from_website"},{"step":"template","done":true,"tool":"create_template"},{"step":"campaign","done":false,"tool":"create_campaign"},{"step":"leads","done":false,"tool":"import_leads"}],"plan":{"active":true,"writes_blocked":false,"fix_url":null},"sandbox":false,"note":"One workspace is one client: all pages here describe this workspace's company."}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/brands":{"get":{"operationId":"listBrands","summary":"List brands","description":"The workspace's brands: the look of a page (logo, colours, fonts). Pass one as brand_id on a job; it overrides the template's own brand.","tags":["Brands"],"responses":{"200":{"description":"The brands.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandList"},"example":{"object":"list","data":[{"object":"brand","id":"brd_c91200b9c0034964bad543c932f2853d","name":"acme.com","status":"ready","website":"https://acme.com","logo":{"url":"https://cdn.neuropage.io/brands/acme/logo.png","dark_url":"https://cdn.neuropage.io/brands/acme/logo-dark.png"},"colors":{"primary":"#0F62FE","background":"#FFFFFF","text":"#111827","heading":"#111827","accent":"#F59E0B"},"fonts":{"heading":"Inter","body":"Inter"},"is_default":true,"edit_url":"https://neuropage.io/home/acme/templates","warnings":[]}],"has_more":false}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}},"post":{"operationId":"createBrandFromWebsite","summary":"Create a brand from a website","description":"Reads the logo, colours and fonts from a company website. Returns at once with the brand and a job; follow the job with `GET /jobs/{id}?wait=50` until it is completed, then check the brand. When the workspace has no company description yet, it is read from the same website. Free.","tags":["Brands"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBrandRequest"},"example":{"website_url":"acme.com"}}}},"responses":{"202":{"description":"The brand is being read.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBrandResponse"},"example":{"brand":{"object":"brand","id":"brd_c91200b9c0034964bad543c932f2853d","name":"acme.com","status":"extracting","website":"https://acme.com","logo":{"url":null,"dark_url":null},"colors":{"primary":null,"background":null,"text":null,"heading":null,"accent":null},"fonts":{"heading":null,"body":null},"is_default":true,"edit_url":"https://neuropage.io/home/acme/templates","warnings":[]},"job":{"object":"job","id":"job_8e2f1c0a9b7d4e6f8a1b2c3d4e5f6a7b","type":"brand_from_website","status":"running","brand_id":"brd_c91200b9c0034964bad543c932f2853d","poll_after_seconds":10,"created_at":"2026-10-27T13:30:02.114Z"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/PlanRequired"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/brands/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The brand id.","schema":{"type":"string","pattern":"^brd_[0-9a-f]{32}$"}}],"get":{"operationId":"getBrand","summary":"Get a brand","description":"One brand with its logo, colours and fonts.","tags":["Brands"],"responses":{"200":{"description":"The brand.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Brand"},"example":{"object":"brand","id":"brd_c91200b9c0034964bad543c932f2853d","name":"acme.com","status":"ready","website":"https://acme.com","logo":{"url":"https://cdn.neuropage.io/brands/acme/logo.png","dark_url":"https://cdn.neuropage.io/brands/acme/logo-dark.png"},"colors":{"primary":"#0F62FE","background":"#FFFFFF","text":"#111827","heading":"#111827","accent":"#F59E0B"},"fonts":{"heading":"Inter","body":"Inter"},"is_default":true,"edit_url":"https://neuropage.io/home/acme/templates","warnings":[]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}},"patch":{"operationId":"updateBrand","summary":"Update a brand","description":"Change the name, logo, colours, fonts or default. Only the fields you send change. Problems that do not block the change come back as `warnings`.","tags":["Brands"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateBrandRequest"},"example":{"colors":{"primary":"#0F62FE"},"fonts":{"heading":"Poppins"}}}}},"responses":{"200":{"description":"The updated brand.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateBrandResponse"},"example":{"brand":{"object":"brand","id":"brd_c91200b9c0034964bad543c932f2853d","name":"acme.com","status":"ready","website":"https://acme.com","logo":{"url":"https://cdn.neuropage.io/brands/acme/logo.png","dark_url":"https://cdn.neuropage.io/brands/acme/logo-dark.png"},"colors":{"primary":"#0F62FE","background":"#FFFFFF","text":"#111827","heading":"#111827","accent":"#F59E0B"},"fonts":{"heading":"Inter","body":"Inter"},"is_default":true,"edit_url":"https://neuropage.io/home/acme/templates","warnings":[]},"warnings":[{"field":"colors.text","message":"Text on background has a contrast of 3.1:1. 4.5:1 or more reads well."}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/PlanRequired"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/templates":{"get":{"operationId":"listTemplates","summary":"List templates","description":"The workspace's templates: sections, call to action, the lead fields they use, and what one page costs. Open a template's `edit_url` to change it in the app.","tags":["Templates"],"responses":{"200":{"description":"The templates.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateList"},"example":{"object":"list","data":[{"object":"template","id":"tpl_568c6ef294b649bebed2353fffe98920","name":"Founder page","sections":["hero","problem","solution","howItWorks","faq","cta"],"cta":{"type":"scheduleMeeting","url":"https://cal.com/acme/intro","ready":true,"issue":null},"brand_id":"brd_c91200b9c0034964bad543c932f2853d","lead_fields":{"required":["linkedin_url"],"optional":["first_name","last_name","company","email","company_website","external_ref"]},"cost_per_asset":3,"edit_url":"https://neuropage.io/home/acme/templates/founder-page"}],"has_more":false}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}},"post":{"operationId":"createTemplate","summary":"Create a template","description":"Makes a template (the layout): which built-in sections a page has, in what order, and its call to action. Pass `brand_id` to link an existing brand as its look, or leave it out and pass `brand_id` on each job. A call to action with nowhere to go is refused with the reason, so a new template is always usable. Custom blocks, proof, pricing and the visual editor are in the app (`edit_url`). Free.","tags":["Templates"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTemplateRequest"},"example":{"name":"Founder page","sections":["problem","solution","howItWorks","faq"],"cta":{"type":"scheduleMeeting","url":"https://cal.com/acme/intro","text":"Book a call"},"brand_id":"brd_c91200b9c0034964bad543c932f2853d"}}}},"responses":{"201":{"description":"The new template.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Template"},"example":{"object":"template","id":"tpl_568c6ef294b649bebed2353fffe98920","name":"Founder page","sections":["hero","problem","solution","howItWorks","faq","cta"],"cta":{"type":"scheduleMeeting","url":"https://cal.com/acme/intro","ready":true,"issue":null},"brand_id":"brd_c91200b9c0034964bad543c932f2853d","lead_fields":{"required":["linkedin_url"],"optional":["first_name","last_name","company","email","company_website","external_ref"]},"cost_per_asset":3,"edit_url":"https://neuropage.io/home/acme/templates/founder-page"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/PlanRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/templates/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The template id.","schema":{"type":"string","pattern":"^tpl_[0-9a-f]{32}$"}}],"get":{"operationId":"getTemplate","summary":"Get a template","description":"One template with its sections, call to action and own brand.","tags":["Templates"],"responses":{"200":{"description":"The template.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Template"},"example":{"object":"template","id":"tpl_568c6ef294b649bebed2353fffe98920","name":"Founder page","sections":["hero","problem","solution","howItWorks","faq","cta"],"cta":{"type":"scheduleMeeting","url":"https://cal.com/acme/intro","ready":true,"issue":null},"brand_id":"brd_c91200b9c0034964bad543c932f2853d","lead_fields":{"required":["linkedin_url"],"optional":["first_name","last_name","company","email","company_website","external_ref"]},"cost_per_asset":3,"edit_url":"https://neuropage.io/home/acme/templates/founder-page"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/jobs":{"post":{"operationId":"createJob","summary":"Generate assets","description":"Make one personalized landing page per lead, from each lead's LinkedIn profile URL. 1 to 25 leads per job. The job is quoted first; with too few credits nothing starts (`402`). Invalid rows are rejected and the rest run. A lead that already has a page in the campaign is reused at no charge. Returns `202` with a running job; follow it with `GET /jobs/{id}?wait=50`. Never send the job again to check progress. Send `dry_run: true` to get the quote as a `200` JobQuote first: the credits it would cost, how many leads would get a new page or reuse one, and whether the balance covers it. Nothing is started.","tags":["Jobs"],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Any string up to 100 characters. The same key within 24 hours returns the first job (200) instead of starting another.","schema":{"type":"string","maxLength":100}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateJobRequest"},"example":{"type":"landing_page","brand_id":"brd_c91200b9c0034964bad543c932f2853d","template_id":"tpl_568c6ef294b649bebed2353fffe98920","leads":[{"linkedin_url":"https://www.linkedin.com/in/jane-doe","first_name":"Jane","last_name":"Doe","company":"Acme","external_ref":"row-1"},{"linkedin_url":"https://www.linkedin.com/in/john-roe","external_ref":"row-2"}]}}}},"responses":{"200":{"description":"With `dry_run: true`: the quote, nothing started. Otherwise the job this Idempotency-Key already started.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/JobQuote"},{"$ref":"#/components/schemas/AssetJob"}]},"examples":{"quote":{"summary":"Dry run","value":{"object":"job_quote","type":"landing_page","campaign_id":"cmp_5b5c31b9cf6447519e3a5eab4ad4797b","leads_accepted":2,"leads_reused":1,"leads_rejected":[{"position":3,"external_ref":"row-4","code":"invalid_linkedin_url","reason":"That is a company page. Paste the profile of a person at that company instead."}],"cost_per_asset":3,"credits_quoted":5,"credits_remaining":4972,"enough_credits":true}},"replayed":{"summary":"Idempotency-Key replay","value":{"object":"job","id":"job_5ce5d74e89b74e10a1dffaa9019b201a","type":"assets","asset_type":"landing_page","status":"completed","brand_id":"brd_c91200b9c0034964bad543c932f2853d","template_id":"tpl_568c6ef294b649bebed2353fffe98920","campaign_id":"cmp_5b5c31b9cf6447519e3a5eab4ad4797b","counts":{"total":4,"queued":0,"processing":0,"ready":3,"failed":0,"rejected":1},"rejected":[{"position":3,"external_ref":"row-4","code":"invalid_linkedin_url","message":"That is a company page. Paste the profile of a person at that company instead.","credits_refunded":0}],"cost":{"quoted":8,"charged":8,"refunded":0,"currency":"credits"},"refunded":false,"credits_refunded":0,"refund_message":null,"credits_remaining":4964,"eta":{"eta_at":null,"eta_seconds":null},"poll_after_seconds":null,"app_url":"https://neuropage.io/home/acme/campaigns/5b5c31b9-cf64-4751-9e3a-5eab4ad4797b","created_at":"2026-10-27T13:39:51.035Z"}}}}}},"202":{"description":"The job was started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetJob"},"example":{"object":"job","id":"job_5ce5d74e89b74e10a1dffaa9019b201a","type":"assets","asset_type":"landing_page","status":"running","brand_id":"brd_c91200b9c0034964bad543c932f2853d","template_id":"tpl_568c6ef294b649bebed2353fffe98920","campaign_id":"cmp_5b5c31b9cf6447519e3a5eab4ad4797b","counts":{"total":4,"queued":0,"processing":3,"ready":0,"failed":0,"rejected":1},"rejected":[{"position":3,"external_ref":"row-4","code":"invalid_linkedin_url","message":"That is a company page. Paste the profile of a person at that company instead.","credits_refunded":0}],"cost":{"quoted":8,"charged":8,"refunded":0,"currency":"credits"},"refunded":false,"credits_refunded":0,"refund_message":null,"credits_remaining":4964,"eta":{"eta_at":"2026-10-27T13:40:52.238Z","eta_seconds":58},"poll_after_seconds":15,"app_url":"https://neuropage.io/home/acme/campaigns/5b5c31b9-cf64-4751-9e3a-5eab4ad4797b","created_at":"2026-10-27T13:39:51.035Z"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientCredits"},"403":{"$ref":"#/components/responses/PlanRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/jobs/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The job id.","schema":{"type":"string","pattern":"^job_[0-9a-f]{32}$"}}],"get":{"operationId":"getJob","summary":"Get a job","description":"A job's status, counts, cost and ETA. With `wait`, the call returns as soon as anything changes. A page job is done when its status is `completed`, `completed_with_errors` or `failed`; then list its assets. There is no job-completion webhook: poll this, or send the job into a campaign that sends `lead.ready` to a webhook (see Webhooks).","tags":["Jobs"],"parameters":[{"name":"wait","in":"query","required":false,"description":"Hold the call up to this many seconds and return as soon as anything changes.","schema":{"type":"integer","minimum":0,"maximum":50,"default":0}}],"responses":{"200":{"description":"The job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Job"},"examples":{"assets":{"summary":"Page job","value":{"object":"job","id":"job_5ce5d74e89b74e10a1dffaa9019b201a","type":"assets","asset_type":"landing_page","status":"running","brand_id":"brd_c91200b9c0034964bad543c932f2853d","template_id":"tpl_568c6ef294b649bebed2353fffe98920","campaign_id":"cmp_5b5c31b9cf6447519e3a5eab4ad4797b","counts":{"total":4,"queued":0,"processing":3,"ready":0,"failed":0,"rejected":1},"rejected":[{"position":3,"external_ref":"row-4","code":"invalid_linkedin_url","message":"That is a company page. Paste the profile of a person at that company instead.","credits_refunded":0}],"cost":{"quoted":8,"charged":8,"refunded":0,"currency":"credits"},"refunded":false,"credits_refunded":0,"refund_message":null,"credits_remaining":4964,"eta":{"eta_at":"2026-10-27T13:40:52.238Z","eta_seconds":58},"poll_after_seconds":15,"app_url":"https://neuropage.io/home/acme/campaigns/5b5c31b9-cf64-4751-9e3a-5eab4ad4797b","created_at":"2026-10-27T13:39:51.035Z"}},"brand":{"summary":"Brand job","value":{"object":"job","id":"job_8e2f1c0a9b7d4e6f8a1b2c3d4e5f6a7b","type":"brand_from_website","status":"running","brand_id":"brd_c91200b9c0034964bad543c932f2853d","poll_after_seconds":10,"created_at":"2026-10-27T13:30:02.114Z"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/assets":{"get":{"operationId":"listAssets","summary":"List assets","description":"Every asset in a job (in the order you sent the leads) or in a campaign (newest first). Pass exactly one of `job_id` or `campaign_id`.","tags":["Assets"],"parameters":[{"name":"job_id","in":"query","schema":{"type":"string"},"description":"Assets of this job."},{"name":"campaign_id","in":"query","schema":{"type":"string"},"description":"Assets of this campaign."},{"name":"type","in":"query","schema":{"type":"string","enum":["landing_page"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":25}},{"name":"starting_after","in":"query","schema":{"type":"string"},"description":"The last asset id of the previous page."}],"responses":{"200":{"description":"The assets.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetList"},"example":{"object":"list","data":[{"object":"asset","id":"ast_30d2ee14acbd4c36883c45d580ff2b0c","type":"landing_page","status":"ready","job_id":"job_5ce5d74e89b74e10a1dffaa9019b201a","campaign_id":"cmp_5b5c31b9cf6447519e3a5eab4ad4797b","external_ref":"row-1","lead":{"linkedin_url":"https://www.linkedin.com/in/jane-doe","name":"Jane Doe","company":"Acme"},"url":"https://pages.neuropage.io/acme/jane-doe-acme-x7k2p","edit_url":"https://neuropage.io/home/acme/leads/jane-doe-acme-x7k2p","progress":{"stage":"ready","percent":100},"error":null,"reused":false,"ready_at":"2026-10-27T13:41:06.941Z"}],"has_more":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/assets/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The asset id.","schema":{"type":"string","pattern":"^ast_[0-9a-f]{32}$"}}],"get":{"operationId":"getAsset","summary":"Get an asset","description":"One lead's page: its status, progress, and the URL once ready. The URL is permanent.","tags":["Assets"],"parameters":[{"name":"wait","in":"query","required":false,"description":"Hold the call up to this many seconds and return as soon as anything changes.","schema":{"type":"integer","minimum":0,"maximum":50,"default":0}}],"responses":{"200":{"description":"The asset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"},"example":{"object":"asset","id":"ast_30d2ee14acbd4c36883c45d580ff2b0c","type":"landing_page","status":"ready","job_id":"job_5ce5d74e89b74e10a1dffaa9019b201a","campaign_id":"cmp_5b5c31b9cf6447519e3a5eab4ad4797b","external_ref":"row-1","lead":{"linkedin_url":"https://www.linkedin.com/in/jane-doe","name":"Jane Doe","company":"Acme"},"url":"https://pages.neuropage.io/acme/jane-doe-acme-x7k2p","edit_url":"https://neuropage.io/home/acme/leads/jane-doe-acme-x7k2p","progress":{"stage":"ready","percent":100},"error":null,"reused":false,"ready_at":"2026-10-27T13:41:06.941Z"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/stats":{"get":{"operationId":"getStats","summary":"Get asset stats","description":"Which leads viewed their page: visits, deepest scroll, CTA clicks, form fills and booked meetings per asset, hottest first, with totals. Pass one of `job_id`, `campaign_id` or `asset_ids`.","tags":["Stats"],"parameters":[{"name":"job_id","in":"query","schema":{"type":"string"}},{"name":"campaign_id","in":"query","schema":{"type":"string"}},{"name":"asset_ids","in":"query","schema":{"type":"string"},"description":"Comma-separated ast_ ids, at most 100."},{"name":"since","in":"query","schema":{"type":"string","format":"date-time"},"description":"Only activity from this moment on."}],"responses":{"200":{"description":"The stats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Stats"},"example":{"object":"stats","since":"2026-10-20T00:00:00.000Z","totals":{"assets":3,"viewed":1,"visits":2,"cta_clicks":1,"forms":0,"meetings":1},"data":[{"asset_id":"ast_30d2ee14acbd4c36883c45d580ff2b0c","lead":{"name":"Jane Doe","company":"Acme","linkedin_url":"https://www.linkedin.com/in/jane-doe"},"url":"https://pages.neuropage.io/acme/jane-doe-acme-x7k2p","visits":2,"first_viewed_at":"2026-10-27T15:02:11.000Z","last_viewed_at":"2026-10-28T09:14:40.000Z","max_scroll":100,"cta_clicks":1,"forms":0,"meetings":1},{"asset_id":"ast_4f9bf7c114744d66a0d88bf250fff16e","lead":{"name":"John Roe","company":"Roe Logistics","linkedin_url":"https://www.linkedin.com/in/john-roe"},"url":"https://pages.neuropage.io/acme/john-roe-roe-logistics-x7k2p","visits":0,"first_viewed_at":null,"last_viewed_at":null,"max_scroll":0,"cta_clicks":0,"forms":0,"meetings":0}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}}}},"webhooks":{"lead.ready":{"post":{"operationId":"webhook_lead_ready","summary":"Lead ready (lead.ready)","description":"**Fires when:** A lead's page is ready and its campaign sends the lead to this webhook: the campaign's **Autopilot, Send** stage uses the tool **Webhook** with this webhook picked, and the stage is armed. NeuroPage first waits for everything the stage requires (the page, and email or LinkedIn messages when picked). A manual send from the campaign sends it too. Once per lead: a lead already sent is skipped unless you send it again from the campaign. A paused campaign sends nothing.\n\nNeuroPage sends `POST` with `Content-Type: application/json`, `User-Agent: NeuroPage-Webhooks/1.0` and, when set, your auth header. When the webhook has a signing secret (MCP subscriptions always do), it also sends `X-NeuroPage-Signature: t=<unix>,v1=<hex>`, where v1 is hex HMAC-SHA256 of `${t}.${body}` with the signing secret. App-created webhooks stay unsigned unless a signing secret was stored. Answer with any 2xx within 15 seconds; redirects are not followed. A timeout, network error, 408, 429 or 5xx is retried a few times within minutes; see Webhooks in the guide.","tags":["Webhook events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadReadyEvent"},"example":{"event":"lead.ready","sent_at":"2026-01-01T00:00:00.000Z","lead_id":"00000000-0000-0000-0000-000000000000","campaign_id":"00000000-0000-0000-0000-000000000000","campaign_name":"Test campaign","first_name":"Ada","last_name":"Lovelace","email":"ada@example.com","linkedin_url":"https://www.linkedin.com/in/ada-lovelace","company":"Analytical Engines","job_title":"Head of Growth","company_domain":"example.com","page_url":"https://pages.neuropage.io/example/ada-lovelace","email_subject_step_1":"A page we made for Analytical Engines","email_opening_step_1":"Ada, I put together a short page on how you could ...","li_connection_note":"Hi Ada, made something for you ...","li_message_1":"Here is the page I mentioned ...","source_fields":{"row_id":"r_123"}}}}},"responses":{"2XX":{"description":"Delivered. The body is ignored."}}}},"page.ready":{"post":{"operationId":"webhook_page_ready","summary":"Page ready (page.ready)","description":"**Fires when:** A lead's landing page is hosted and has a permanent URL. Every campaign in the workspace, including pages made through the API or MCP. No Send-stage setup is required. Sent once per lead; a later successful delivery is not repeated.\n\nNeuroPage sends `POST` with `Content-Type: application/json`, `User-Agent: NeuroPage-Webhooks/1.0` and, when set, your auth header. When the webhook has a signing secret (MCP subscriptions always do), it also sends `X-NeuroPage-Signature: t=<unix>,v1=<hex>`, where v1 is hex HMAC-SHA256 of `${t}.${body}` with the signing secret. App-created webhooks stay unsigned unless a signing secret was stored. Answer with any 2xx within 15 seconds; redirects are not followed. A timeout, network error, 408, 429 or 5xx is tried twice more in the next few seconds. There is no durable retry queue for these events yet.","tags":["Webhook events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageReadyEvent"},"example":{"event":"page.ready","sent_at":"2026-01-01T00:00:00.000Z","lead_id":"00000000-0000-0000-0000-000000000000","campaign_id":"00000000-0000-0000-0000-000000000000","campaign_name":"Test campaign","job_id":"job_01example","first_name":"Ada","last_name":"Lovelace","email":"ada@example.com","linkedin_url":"https://www.linkedin.com/in/ada-lovelace","company":"Analytical Engines","job_title":"Head of Growth","company_domain":"example.com","page_url":"https://pages.neuropage.io/example/ada-lovelace","source_fields":{"row_id":"r_123"}}}}},"responses":{"2XX":{"description":"Delivered. The body is ignored."}}}},"job.failed":{"post":{"operationId":"webhook_job_failed","summary":"Job failed (job.failed)","description":"**Fires when:** An API or MCP asset job ended with no ready pages (every accepted lead failed or was canceled). Not sent when the job is completed_with_errors. Sent once per job. The body is job-level: `job_id`, `error`, `failed_lead_ids`. Brand-from-website jobs are not included yet.\n\nNeuroPage sends `POST` with `Content-Type: application/json`, `User-Agent: NeuroPage-Webhooks/1.0` and, when set, your auth header. When the webhook has a signing secret (MCP subscriptions always do), it also sends `X-NeuroPage-Signature: t=<unix>,v1=<hex>`, where v1 is hex HMAC-SHA256 of `${t}.${body}` with the signing secret. App-created webhooks stay unsigned unless a signing secret was stored. Answer with any 2xx within 15 seconds; redirects are not followed. A timeout, network error, 408, 429 or 5xx is tried twice more in the next few seconds. There is no durable retry queue for these events yet.","tags":["Webhook events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobFailedEvent"},"example":{"event":"job.failed","sent_at":"2026-01-01T00:00:00.000Z","job_id":"job_01example","job_type":"landing_page","error":"The page could not be generated.","campaign_id":"00000000-0000-0000-0000-000000000000","campaign_name":"Test campaign","failed_lead_ids":["00000000-0000-0000-0000-000000000000"]}}}},"responses":{"2XX":{"description":"Delivered. The body is ignored."}}}},"page.viewed":{"post":{"operationId":"webhook_page_viewed","summary":"Page viewed (page.viewed)","description":"**Fires when:** The lead starts a new visit to their page. Your own previews from the app do not count. Every campaign in the workspace, the API campaign included.\n\nNeuroPage sends `POST` with `Content-Type: application/json`, `User-Agent: NeuroPage-Webhooks/1.0` and, when set, your auth header. When the webhook has a signing secret (MCP subscriptions always do), it also sends `X-NeuroPage-Signature: t=<unix>,v1=<hex>`, where v1 is hex HMAC-SHA256 of `${t}.${body}` with the signing secret. App-created webhooks stay unsigned unless a signing secret was stored. Answer with any 2xx within 15 seconds; redirects are not followed. Sent once, not retried.","tags":["Webhook events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityEvent"},"example":{"event":"page.viewed","sent_at":"2026-01-01T00:00:00.000Z","lead_id":"00000000-0000-0000-0000-000000000000","campaign_id":"00000000-0000-0000-0000-000000000000","campaign_name":"Test campaign","first_name":"Ada","last_name":"Lovelace","email":"ada@example.com","linkedin_url":"https://www.linkedin.com/in/ada-lovelace","company":"Analytical Engines","job_title":"Head of Growth","company_domain":"example.com","page_url":"https://pages.neuropage.io/example/ada-lovelace","country":"NL","source_fields":{"row_id":"r_123"}}}}},"responses":{"2XX":{"description":"Delivered. The body is ignored."}}}},"cta.clicked":{"post":{"operationId":"webhook_cta_clicked","summary":"CTA clicked (cta.clicked)","description":"**Fires when:** The lead clicks the page's call to action. Every campaign in the workspace.\n\nNeuroPage sends `POST` with `Content-Type: application/json`, `User-Agent: NeuroPage-Webhooks/1.0` and, when set, your auth header. When the webhook has a signing secret (MCP subscriptions always do), it also sends `X-NeuroPage-Signature: t=<unix>,v1=<hex>`, where v1 is hex HMAC-SHA256 of `${t}.${body}` with the signing secret. App-created webhooks stay unsigned unless a signing secret was stored. Answer with any 2xx within 15 seconds; redirects are not followed. Sent once, not retried.","tags":["Webhook events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityEvent"},"example":{"event":"cta.clicked","sent_at":"2026-01-01T00:00:00.000Z","lead_id":"00000000-0000-0000-0000-000000000000","campaign_id":"00000000-0000-0000-0000-000000000000","campaign_name":"Test campaign","first_name":"Ada","last_name":"Lovelace","email":"ada@example.com","linkedin_url":"https://www.linkedin.com/in/ada-lovelace","company":"Analytical Engines","job_title":"Head of Growth","company_domain":"example.com","page_url":"https://pages.neuropage.io/example/ada-lovelace","country":"NL","source_fields":{"row_id":"r_123"}}}}},"responses":{"2XX":{"description":"Delivered. The body is ignored."}}}},"form.submitted":{"post":{"operationId":"webhook_form_submitted","summary":"Form submitted (form.submitted)","description":"**Fires when:** The lead submits the form on their page. Carries `visitor_name` and `visitor_email` when given. Every campaign in the workspace.\n\nNeuroPage sends `POST` with `Content-Type: application/json`, `User-Agent: NeuroPage-Webhooks/1.0` and, when set, your auth header. When the webhook has a signing secret (MCP subscriptions always do), it also sends `X-NeuroPage-Signature: t=<unix>,v1=<hex>`, where v1 is hex HMAC-SHA256 of `${t}.${body}` with the signing secret. App-created webhooks stay unsigned unless a signing secret was stored. Answer with any 2xx within 15 seconds; redirects are not followed. Sent once, not retried.","tags":["Webhook events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityEvent"},"example":{"event":"form.submitted","sent_at":"2026-01-01T00:00:00.000Z","lead_id":"00000000-0000-0000-0000-000000000000","campaign_id":"00000000-0000-0000-0000-000000000000","campaign_name":"Test campaign","first_name":"Ada","last_name":"Lovelace","email":"ada@example.com","linkedin_url":"https://www.linkedin.com/in/ada-lovelace","company":"Analytical Engines","job_title":"Head of Growth","company_domain":"example.com","page_url":"https://pages.neuropage.io/example/ada-lovelace","country":"NL","visitor_name":"Ada Lovelace","visitor_email":"ada@example.com","source_fields":{"row_id":"r_123"}}}}},"responses":{"2XX":{"description":"Delivered. The body is ignored."}}}},"meeting.booked":{"post":{"operationId":"webhook_meeting_booked","summary":"Meeting booked (meeting.booked)","description":"**Fires when:** The lead books a meeting through the Calendly or Cal.com embed on their page. Carries `provider` and `scheduled_at`. Every campaign in the workspace.\n\nNeuroPage sends `POST` with `Content-Type: application/json`, `User-Agent: NeuroPage-Webhooks/1.0` and, when set, your auth header. When the webhook has a signing secret (MCP subscriptions always do), it also sends `X-NeuroPage-Signature: t=<unix>,v1=<hex>`, where v1 is hex HMAC-SHA256 of `${t}.${body}` with the signing secret. App-created webhooks stay unsigned unless a signing secret was stored. Answer with any 2xx within 15 seconds; redirects are not followed. Sent once, not retried.","tags":["Webhook events"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityEvent"},"example":{"event":"meeting.booked","sent_at":"2026-01-01T00:00:00.000Z","lead_id":"00000000-0000-0000-0000-000000000000","campaign_id":"00000000-0000-0000-0000-000000000000","campaign_name":"Test campaign","first_name":"Ada","last_name":"Lovelace","email":"ada@example.com","linkedin_url":"https://www.linkedin.com/in/ada-lovelace","company":"Analytical Engines","job_title":"Head of Growth","company_domain":"example.com","page_url":"https://pages.neuropage.io/example/ada-lovelace","country":"NL","provider":"calendly","scheduled_at":"2026-01-08T10:00:00.000Z","source_fields":{"row_id":"r_123"}}}}},"responses":{"2XX":{"description":"Delivered. The body is ignored."}}}}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"np_live_...","description":"Your API key from Settings, API & MCP, as Authorization: Bearer np_live_..."}},"schemas":{"Problem":{"type":"object","description":"An error, as RFC 9457 problem details (application/problem+json).","required":["type","title","status","code","detail","request_id"],"properties":{"type":{"type":"string","format":"uri","description":"https://neuropage.io/about/documentation/api#<code>: the code's entry in these docs."},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string","enum":["invalid_request","unauthorized","insufficient_credits","spend_cap_reached","plan_required","not_found","campaign_not_eligible","idempotency_conflict","brand_not_ready","template_not_usable","validation_failed","too_many_leads","rate_limited","internal_error","temporarily_unavailable"],"description":"Stable. Branch on this."},"detail":{"type":"string","description":"For people. Do not parse it."},"instance":{"type":"string"},"request_id":{"type":"string","examples":["req_76c14c0b4bc4701a148d33ab"]},"hint":{"type":"string","description":"The next step, in one sentence."},"fix":{"type":"object","description":"A url to show the user, or an MCP tool to call.","properties":{"url":{"type":"string"},"tool":{"type":"string"}}},"errors":{"type":"array","description":"Every invalid field, on 422 validation_failed.","items":{"type":"object","properties":{"field":{"type":"string","examples":["leads[3].linkedin_url"]},"code":{"type":"string"},"detail":{"type":"string"}}}},"limit":{"type":"string","enum":["requests","running_jobs","assets_hour","assets_day","workspaces_day"],"description":"On 429: which limit was reached. workspaces_day is the MCP create_workspace limit."}}},"Workspace":{"type":"object","properties":{"object":{"const":"workspace"},"slug":{"type":"string"},"name":{"type":"string"},"app_url":{"type":"string","format":"uri"},"credits":{"type":"object","properties":{"remaining":{"type":"number"},"currency":{"const":"credits"}}},"cost_per_asset":{"type":"number","description":"The most one new landing page costs in the workspace API campaign. A lead whose profile NeuroPage already read costs less. A template can cost more when its campaign runs research."},"company":{"type":["object","null"],"description":"What pages say about your company. Null until it is set up.","properties":{"description":{"type":["string","null"]},"website":{"type":["string","null"]}}},"brands":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"website":{"type":["string","null"]},"is_default":{"type":"boolean"}}}},"templates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}}},"missing":{"type":"array","description":"What to set up before pages look right, with the tool that fixes it.","items":{"type":"object","properties":{"field":{"type":"string","enum":["brand","company"]},"why":{"type":"string"},"fix":{"type":"object","properties":{"tool":{"type":"string"}}}}}},"setup":{"type":"array","description":"How far the setup is, in the order to finish it, with the MCP tool for each step.","items":{"type":"object","properties":{"step":{"type":"string","enum":["company","brand","template","campaign","leads"]},"done":{"type":"boolean"},"tool":{"type":"string"}}}},"plan":{"type":"object","description":"Whether this workspace may change anything. Reads always work. Without a paid plan or a trial with a card, every write (POST, PATCH, and the MCP tools that create or change things) is refused with 403 plan_required.","properties":{"active":{"type":"boolean"},"writes_blocked":{"type":"boolean"},"fix_url":{"type":["string","null"],"format":"uri","description":"Where the user starts a plan, while writes are blocked."}}},"sandbox":{"type":"boolean","description":"True only for a sandbox key on the shared sandbox workspace: low caps, and every response also carries the header NeuroPage-Sandbox: true."},"note":{"type":"string"}}},"Brand":{"type":"object","description":"The look of a page: logo, colours and fonts. The layout (sections, call to action) is the template. A job's brand overrides the template's own brand.","properties":{"object":{"const":"brand"},"id":{"type":"string","examples":["brd_c91200b9c0034964bad543c932f2853d"]},"name":{"type":"string"},"status":{"type":"string","enum":["extracting","ready","failed"],"description":"extracting while the website is read: logo, colors and fonts are null until it is ready. failed means the brand exists with default styling."},"website":{"type":["string","null"],"description":"The website the brand was read from."},"logo":{"type":"object","properties":{"url":{"type":["string","null"],"description":"Logo for light backgrounds. An https URL or a data:image URI (svg, png, jpeg, webp)."},"dark_url":{"type":["string","null"],"description":"Logo for dark backgrounds. An https URL or a data:image URI (svg, png, jpeg, webp)."}}},"colors":{"type":"object","properties":{"primary":{"type":["string","null"],"pattern":"^#[0-9A-Fa-f]{6}$"},"background":{"type":["string","null"],"pattern":"^#[0-9A-Fa-f]{6}$"},"text":{"type":["string","null"],"pattern":"^#[0-9A-Fa-f]{6}$"},"heading":{"type":["string","null"],"pattern":"^#[0-9A-Fa-f]{6}$"},"accent":{"type":["string","null"],"pattern":"^#[0-9A-Fa-f]{6}$"}}},"fonts":{"type":"object","properties":{"heading":{"type":["string","null"]},"body":{"type":["string","null"]}}},"is_default":{"type":"boolean"},"edit_url":{"type":"string","format":"uri"},"warnings":{"type":"array","description":"Problems to fix before making pages, such as a missing, tiny or hard to see logo.","items":{"type":"object","properties":{"field":{"type":"string","examples":["logo.url"]},"message":{"type":"string"}}}}}},"BrandList":{"type":"object","properties":{"object":{"const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Brand"}},"has_more":{"type":"boolean","description":"More results exist. Pass the last id as starting_after to get them."}}},"CreateBrandRequest":{"type":"object","required":["website_url"],"properties":{"website_url":{"type":"string","description":"The company website. https:// is added when missing.","examples":["acme.com"]},"name":{"type":"string","maxLength":100,"description":"Defaults to the hostname without www."}}},"CreateBrandResponse":{"type":"object","properties":{"brand":{"$ref":"#/components/schemas/Brand"},"job":{"$ref":"#/components/schemas/BrandJob"}}},"UpdateBrandRequest":{"type":"object","description":"Only the fields you send change.","properties":{"name":{"type":"string","maxLength":100},"logo_url":{"type":"string","format":"uri","description":"An image URL. We download and store it; files over 2 MB and non-images are refused."},"colors":{"type":"object","description":"Each as #RRGGBB. Text on background below 4.5:1 contrast is kept, with a warning.","properties":{"primary":{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$"},"background":{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$"},"text":{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$"},"heading":{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$"},"accent":{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$"}}},"fonts":{"type":"object","description":"A Google Font or a font uploaded to the workspace. Anything else keeps the old font, with a warning.","properties":{"heading":{"type":"string"},"body":{"type":"string"}}},"is_default":{"type":"boolean","description":"true makes this the default brand and clears it on the others."}}},"UpdateBrandResponse":{"type":"object","properties":{"brand":{"$ref":"#/components/schemas/Brand"},"warnings":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}}}}}},"Template":{"type":"object","description":"The layout of a page: sections and call to action. The look (logo, colours, fonts) is the brand. Made with POST /templates or in the app; custom blocks, proof and pricing are edited in the app (see edit_url).","properties":{"object":{"const":"template"},"id":{"type":"string","examples":["tpl_568c6ef294b649bebed2353fffe98920"]},"name":{"type":"string"},"sections":{"type":"array","items":{"type":"string"},"description":"The built-in sections that are on, in page order: hero first, cta last when the closing call to action is on. Custom blocks made in the app are left out."},"cta":{"type":"object","properties":{"type":{"type":"string","enum":["scheduleMeeting","call","email","form","website"]},"url":{"type":["string","null"]},"ready":{"type":"boolean","description":"False when the CTA has no destination. Jobs with this template are refused with 409 template_not_usable."},"issue":{"type":["string","null"],"description":"What is missing when ready is false."}}},"brand_id":{"type":["string","null"],"description":"The template's own brand, used when a job names no brand_id."},"lead_fields":{"type":"object","properties":{"required":{"type":"array","items":{"type":"string"}},"optional":{"type":"array","items":{"type":"string"}}}},"cost_per_asset":{"type":"number"},"edit_url":{"type":"string","format":"uri"}}},"TemplateList":{"type":"object","properties":{"object":{"const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Template"}},"has_more":{"type":"boolean","description":"More results exist. Pass the last id as starting_after to get them."}}},"CreateTemplateRequest":{"type":"object","required":["name"],"additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":120},"sections":{"type":"array","items":{"type":"string","enum":["socialProofBar","problem","solution","howItWorks","whyUs","faq","pricing","comparisonTable"]},"uniqueItems":true,"description":"The sections between the hero and the closing call to action, in page order. Defaults to problem, solution, howItWorks, whyUs, faq. Every page opens with the hero and closes with the call to action, so hero and cta may be sent and are ignored. Custom blocks are made in the app.","default":["problem","solution","howItWorks","whyUs","faq"]},"cta":{"type":"object","additionalProperties":false,"description":"The call to action every button on the page uses. Defaults to a form.","properties":{"type":{"type":"string","enum":["form","scheduleMeeting","call","email","website"],"default":"form","description":"form opens a name and email form on the page and needs no url. The others need url."},"url":{"type":["string","null"],"description":"Where the button goes: a booking link (scheduleMeeting), a phone number (call), an email address (email) or an https page (website). tel: and mailto: are accepted. Leave it out for form.","maxLength":2000},"text":{"type":["string","null"],"description":"The button label.","maxLength":60}}},"brand_id":{"type":["string","null"],"description":"The template's own brand (the look), used when a job names no brand_id. Linked, not copied: one brand can be the look of many templates. It must be done extracting.","examples":["brd_c91200b9c0034964bad543c932f2853d"]}}},"LeadInput":{"type":"object","required":["linkedin_url"],"properties":{"linkedin_url":{"type":"string","description":"A personal profile, like linkedin.com/in/jane-doe. Company pages are rejected."},"first_name":{"type":"string","maxLength":100},"last_name":{"type":"string","maxLength":100},"company":{"type":"string","maxLength":255},"email":{"type":"string","maxLength":320},"company_website":{"type":"string","maxLength":253},"external_ref":{"type":"string","maxLength":200,"description":"Your own id for this row, echoed back on the asset and on a rejection."}},"description":"Only linkedin_url is required. Names and company are hints written to a new contact; they also make the page URL readable."},"CreateJobRequest":{"type":"object","required":["type","leads"],"properties":{"type":{"type":"string","enum":["landing_page"]},"brand_id":{"type":"string","description":"The look (logo, colours, fonts). Overrides the template's own brand."},"template_id":{"type":"string","description":"The layout (sections, call to action)."},"campaign_id":{"type":"string","description":"Add the leads to this campaign instead of the workspace API campaign. It must be active with automatic page generation on. If its Send stage sends to a webhook, each lead fires `lead.ready` there when ready (see Webhooks)."},"language":{"type":"string","enum":["en","nl","de","fr","es","sv","nb","fi"],"default":"en","description":"The page language. Leave it out when you pass campaign_id: the campaign sets it."},"leads":{"type":"array","minItems":1,"maxItems":25,"items":{"$ref":"#/components/schemas/LeadInput"}},"dry_run":{"type":"boolean","default":false,"description":"true returns a JobQuote (200) with what the job would cost and which leads would be reused, and starts nothing: no job, no charge, and the Idempotency-Key is not used."}}},"JobQuote":{"type":"object","description":"The answer to a dry run: the job quoted lead by lead, as the real run would charge it. Nothing was started.","properties":{"object":{"const":"job_quote"},"type":{"type":"string","enum":["landing_page"]},"campaign_id":{"type":["string","null"],"description":"The campaign the pages would go in. Null when the workspace API campaign does not exist yet (the real run creates it)."},"leads_accepted":{"type":"integer","description":"Leads that would get a new page, and so be charged: new ones and failed ones tried again."},"leads_reused":{"type":"integer","description":"Leads that already have a page in the campaign. Reused at no charge."},"leads_rejected":{"type":"array","description":"Leads the real run would reject, with the reason.","items":{"type":"object","properties":{"position":{"type":"integer"},"external_ref":{"type":["string","null"]},"code":{"type":"string","enum":["invalid_linkedin_url","duplicate_in_request"]},"reason":{"type":"string"}}}},"cost_per_asset":{"type":"number","description":"The most one new page costs here: persona analysis, the page and the research columns the campaign runs."},"credits_quoted":{"type":"number","description":"What the accepted leads would be charged in total. A lead whose profile NeuroPage already read costs only the page."},"credits_remaining":{"type":"number"},"enough_credits":{"type":"boolean","description":"false when the real run would be refused with 402 insufficient_credits."}}},"AssetJob":{"type":"object","description":"A job that makes assets.","properties":{"object":{"const":"job"},"id":{"type":"string","examples":["job_5ce5d74e89b74e10a1dffaa9019b201a"]},"type":{"const":"assets"},"asset_type":{"type":"string","enum":["landing_page"]},"status":{"type":"string","enum":["running","completed","completed_with_errors","failed"]},"brand_id":{"type":["string","null"]},"template_id":{"type":["string","null"]},"campaign_id":{"type":["string","null"]},"counts":{"type":"object","properties":{"total":{"type":"integer"},"queued":{"type":"integer"},"processing":{"type":"integer"},"ready":{"type":"integer"},"failed":{"type":"integer"},"rejected":{"type":"integer"}}},"rejected":{"type":"array","description":"Leads that were not started, with the reason.","items":{"type":"object","properties":{"position":{"type":"integer"},"external_ref":{"type":["string","null"]},"code":{"type":"string","examples":["invalid_linkedin_url","duplicate_in_request","temporarily_unavailable"]},"message":{"type":"string"},"credits_refunded":{"type":"number","description":"Credits charged for this lead and given back because it could not start. 0 when nothing was charged."}}}},"cost":{"type":"object","properties":{"quoted":{"type":"number","description":"What the started pages cost, lead by lead. A page that could not start is not quoted."},"charged":{"type":"number","description":"Every debit for this job, including a page that could not start and was refunded."},"refunded":{"type":"number"},"currency":{"const":"credits"}}},"refunded":{"type":"boolean","description":"true when any credit charged for this job was given back: a page that could not start (in this response), or later a page or research that failed."},"credits_refunded":{"type":"number","description":"Credits given back so far. Same as cost.refunded."},"refund_message":{"type":["string","null"],"description":"One plain sentence about the refund, to show the user. Null when nothing was refunded."},"credits_remaining":{"type":"number"},"eta":{"type":"object","properties":{"eta_at":{"type":["string","null"],"format":"date-time"},"eta_seconds":{"type":["integer","null"]}}},"poll_after_seconds":{"type":["integer","null"],"description":"Wait this long before polling again. Null when done."},"app_url":{"type":["string","null"],"format":"uri"},"created_at":{"type":"string","format":"date-time"}}},"BrandJob":{"type":"object","description":"A job that reads a brand from a website.","properties":{"object":{"const":"job"},"id":{"type":"string","examples":["job_8e2f1c0a9b7d4e6f8a1b2c3d4e5f6a7b"]},"type":{"const":"brand_from_website"},"status":{"type":"string","enum":["running","completed","failed"]},"brand_id":{"type":"string"},"poll_after_seconds":{"type":["integer","null"]},"created_at":{"type":"string","format":"date-time"}}},"Job":{"oneOf":[{"$ref":"#/components/schemas/AssetJob"},{"$ref":"#/components/schemas/BrandJob"}],"discriminator":{"propertyName":"type"}},"Asset":{"type":"object","description":"One thing made for one lead. type landing_page: the lead's page.","properties":{"object":{"const":"asset"},"id":{"type":"string","examples":["ast_30d2ee14acbd4c36883c45d580ff2b0c"]},"type":{"type":"string","enum":["landing_page"]},"status":{"type":"string","enum":["queued","processing","ready","failed","canceled"]},"job_id":{"type":["string","null"]},"campaign_id":{"type":["string","null"]},"external_ref":{"type":["string","null"]},"lead":{"type":"object","properties":{"linkedin_url":{"type":["string","null"]},"name":{"type":["string","null"]},"company":{"type":["string","null"]}}},"url":{"type":["string","null"],"description":"The hosted page. Null until ready, then permanent: it does not expire.","format":"uri"},"edit_url":{"type":"string","format":"uri","description":"The lead in the app."},"progress":{"type":"object","properties":{"stage":{"type":"string","enum":["queued","enriching","researching","writing","rendering","ready","failed","idle"]},"percent":{"type":"integer","minimum":0,"maximum":100}}},"error":{"type":["object","null"],"properties":{"code":{"type":"string","enum":["linkedin_profile_not_found","generation_failed","timed_out","temporary_error","configuration_error"]},"message":{"type":"string"},"retryable":{"type":"boolean","description":"true: send the same LinkedIn URL again to retry it."}}},"reused":{"type":"boolean","description":"true when this lead already had a page in the campaign and nothing was charged."},"ready_at":{"type":["string","null"],"format":"date-time"}}},"AssetList":{"type":"object","properties":{"object":{"const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Asset"}},"has_more":{"type":"boolean","description":"More results exist. Pass the last id as starting_after to get them."}}},"Stats":{"type":"object","description":"Who viewed their page. Bots, email security scanners and your own team are left out, the same way the app counts.","properties":{"object":{"const":"stats"},"since":{"type":["string","null"],"format":"date-time"},"totals":{"type":"object","properties":{"assets":{"type":"integer"},"viewed":{"type":"integer","description":"Assets with at least one visit."},"visits":{"type":"integer"},"cta_clicks":{"type":"integer"},"forms":{"type":"integer"},"meetings":{"type":"integer"}}},"data":{"type":"array","description":"One row per asset, hottest first: meetings, forms, CTA clicks, scroll, visits, last view.","items":{"type":"object","properties":{"asset_id":{"type":"string"},"lead":{"type":"object","properties":{"name":{"type":["string","null"]},"company":{"type":["string","null"]},"linkedin_url":{"type":["string","null"]}}},"url":{"type":["string","null"]},"visits":{"type":"integer"},"first_viewed_at":{"type":["string","null"],"format":"date-time"},"last_viewed_at":{"type":["string","null"],"format":"date-time"},"max_scroll":{"type":"integer","enum":[0,25,50,75,100],"description":"Deepest scroll in percent."},"cta_clicks":{"type":"integer"},"forms":{"type":"integer"},"meetings":{"type":"integer"}}}}}},"LeadReadyEvent":{"type":"object","description":"Sent when a lead is ready and its campaign sends to this webhook. Flat on purpose: Clay, Zapier and Make map top-level keys to columns. Message keys use the outreach merge-tag names; a step the campaign does not generate, or that came out empty, is left out rather than sent empty.","required":["event","sent_at","lead_id","campaign_id","campaign_name","first_name","last_name","email","linkedin_url","company","job_title","company_domain","page_url","source_fields"],"properties":{"event":{"type":"string","const":"lead.ready"},"campaign_id":{"type":"string","format":"uuid","description":"The campaign uuid. Its API id is `cmp_` plus this uuid without dashes."},"sent_at":{"type":"string","format":"date-time","description":"When NeuroPage sent this request."},"lead_id":{"type":"string","format":"uuid","description":"The lead. For a page made through the API, the asset id is `ast_` plus this uuid without dashes."},"campaign_name":{"type":["string","null"],"description":"The campaign name."},"first_name":{"type":["string","null"],"description":"Contact first name."},"last_name":{"type":["string","null"],"description":"Contact last name."},"email":{"type":["string","null"],"description":"Contact email, when known."},"linkedin_url":{"type":["string","null"],"description":"Contact LinkedIn profile URL."},"company":{"type":["string","null"],"description":"Contact company."},"job_title":{"type":["string","null"],"description":"Contact job title."},"company_domain":{"type":["string","null"],"description":"Contact company domain."},"page_url":{"type":["string","null"],"description":"The lead's landing page URL. Permanent.","format":"uri"},"source_fields":{"type":"object","additionalProperties":true,"description":"Every extra field the lead arrived with on a campaign inbound webhook (a Clay row id, say), returned untouched. `{}` when there were none, which is the case for leads sent through the API."}},"patternProperties":{"^email_(subject|opening|body)_step_[0-9]+$":{"type":"string","description":"Email step N: subject, opening line, and the full body when the step is a full email. Edited text wins; {{page_url}} is already replaced."},"^li_(connection_note|message_[0-9]+)$":{"type":"string","description":"LinkedIn connection note and message N. Edited text wins; {{page_url}} is already replaced."}},"additionalProperties":false},"ActivityEvent":{"type":"object","description":"Sent when a lead does something on their page, for every campaign in the workspace. Same contact keys as lead.ready, so one receiver can take both. The detail keys are only present when known.","required":["event","sent_at","lead_id","campaign_id","campaign_name","first_name","last_name","email","linkedin_url","company","job_title","company_domain","page_url","source_fields"],"properties":{"event":{"type":"string","enum":["page.viewed","cta.clicked","form.submitted","meeting.booked"]},"campaign_id":{"type":["string","null"],"description":"The campaign uuid. Its API id is `cmp_` plus this uuid without dashes.","format":"uuid"},"sent_at":{"type":"string","format":"date-time","description":"When NeuroPage sent this request."},"lead_id":{"type":"string","format":"uuid","description":"The lead. For a page made through the API, the asset id is `ast_` plus this uuid without dashes."},"campaign_name":{"type":["string","null"],"description":"The campaign name."},"first_name":{"type":["string","null"],"description":"Contact first name."},"last_name":{"type":["string","null"],"description":"Contact last name."},"email":{"type":["string","null"],"description":"Contact email, when known."},"linkedin_url":{"type":["string","null"],"description":"Contact LinkedIn profile URL."},"company":{"type":["string","null"],"description":"Contact company."},"job_title":{"type":["string","null"],"description":"Contact job title."},"company_domain":{"type":["string","null"],"description":"Contact company domain."},"page_url":{"type":["string","null"],"description":"The lead's landing page URL. Permanent.","format":"uri"},"source_fields":{"type":"object","additionalProperties":true,"description":"Every extra field the lead arrived with on a campaign inbound webhook (a Clay row id, say), returned untouched. `{}` when there were none, which is the case for leads sent through the API."},"country":{"type":"string","description":"Visitor country code, when known."},"visitor_name":{"type":"string","description":"form.submitted: the name typed into the form."},"visitor_email":{"type":"string","description":"form.submitted: the email typed into the form."},"provider":{"type":"string","enum":["calendly","calcom"],"description":"meeting.booked: the booking tool."},"scheduled_at":{"type":"string","format":"date-time","description":"meeting.booked: when the meeting starts."}},"additionalProperties":false},"PageReadyEvent":{"type":"object","description":"Sent when a landing page is hosted and has a permanent URL, for every campaign in the workspace, including pages made through the API or MCP. Same contact keys as lead.ready. job_id is set when an API or MCP job made the page.","required":["event","sent_at","lead_id","campaign_id","campaign_name","first_name","last_name","email","linkedin_url","company","job_title","company_domain","page_url","source_fields","job_id"],"properties":{"event":{"type":"string","const":"page.ready"},"campaign_id":{"type":["string","null"],"description":"The campaign uuid. Its API id is `cmp_` plus this uuid without dashes.","format":"uuid"},"sent_at":{"type":"string","format":"date-time","description":"When NeuroPage sent this request."},"lead_id":{"type":"string","format":"uuid","description":"The lead. For a page made through the API, the asset id is `ast_` plus this uuid without dashes."},"campaign_name":{"type":["string","null"],"description":"The campaign name."},"first_name":{"type":["string","null"],"description":"Contact first name."},"last_name":{"type":["string","null"],"description":"Contact last name."},"email":{"type":["string","null"],"description":"Contact email, when known."},"linkedin_url":{"type":["string","null"],"description":"Contact LinkedIn profile URL."},"company":{"type":["string","null"],"description":"Contact company."},"job_title":{"type":["string","null"],"description":"Contact job title."},"company_domain":{"type":["string","null"],"description":"Contact company domain."},"page_url":{"type":["string","null"],"description":"The lead's landing page URL. Permanent.","format":"uri"},"source_fields":{"type":"object","additionalProperties":true,"description":"Every extra field the lead arrived with on a campaign inbound webhook (a Clay row id, say), returned untouched. `{}` when there were none, which is the case for leads sent through the API."},"job_id":{"type":["string","null"],"description":"The API or MCP job that made this page, as a `job_` id. Null when the page was not made through a job."}},"additionalProperties":false},"JobFailedEvent":{"type":"object","description":"Sent once when an API or MCP asset job ends with no ready pages (every accepted lead failed or was canceled). Not sent for completed_with_errors, where some pages are ready. There is no lead_id: this is a job-level event.","required":["event","sent_at","job_id","job_type","error","campaign_id","campaign_name","failed_lead_ids"],"properties":{"event":{"type":"string","const":"job.failed"},"sent_at":{"type":"string","format":"date-time","description":"When NeuroPage sent this request."},"job_id":{"type":"string","description":"The job, as a `job_` id. Use it with get_job or GET /v1/jobs/{id}."},"job_type":{"type":["string","null"],"description":"The asset type of the job, usually landing_page."},"error":{"type":["string","null"],"description":"A short reason, when one is known."},"campaign_id":{"type":["string","null"],"description":"The campaign uuid. Its API id is `cmp_` plus this uuid without dashes.","format":"uuid"},"campaign_name":{"type":["string","null"],"description":"The campaign name."},"failed_lead_ids":{"type":"array","items":{"type":"string","format":"uuid"},"description":"The accepted leads that failed or were canceled."}},"additionalProperties":false}},"responses":{"BadRequest":{"description":"Invalid request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://neuropage.io/about/documentation/api#invalid_request","title":"Invalid request","status":400,"code":"invalid_request","detail":"The body is not valid JSON, or the asset type is unknown.","request_id":"req_76c14c0b4bc4701a148d33ab","hint":"Fix the request. Sending it again unchanged fails again."}}}},"Unauthorized":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://neuropage.io/about/documentation/api#unauthorized","title":"Unauthorized","status":401,"code":"unauthorized","detail":"The API key is missing, unknown or revoked.","request_id":"req_76c14c0b4bc4701a148d33ab","hint":"Send Authorization: Bearer np_live_... with a key from Settings, API & MCP."}}}},"InsufficientCredits":{"description":"Not enough credits","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://neuropage.io/about/documentation/api#insufficient_credits","title":"Not enough credits","status":402,"code":"insufficient_credits","detail":"The workspace has fewer credits than the job costs. Nothing was charged.","request_id":"req_76c14c0b4bc4701a148d33ab","hint":"Add credits at fix.url, or send fewer leads."}}}},"PlanRequired":{"description":"Paid plan required","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://neuropage.io/about/documentation/api#plan_required","title":"Paid plan required","status":403,"code":"plan_required","detail":"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.","request_id":"req_76c14c0b4bc4701a148d33ab","hint":"Show the user fix.url and stop writing. GET /workspace shows the same state in plan."}}}},"NotFound":{"description":"Not found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://neuropage.io/about/documentation/api#not_found","title":"Not found","status":404,"code":"not_found","detail":"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.","request_id":"req_76c14c0b4bc4701a148d33ab","hint":"Use an id this workspace returned. No workspace yet: create one (fix.url, or create_workspace over MCP)."}}}},"Conflict":{"description":"Conflict","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://neuropage.io/about/documentation/api#brand_not_ready","title":"Conflict","status":409,"code":"brand_not_ready","detail":"The brand is still being read from its website.","request_id":"req_76c14c0b4bc4701a148d33ab","hint":"Wait for the brand job with GET /jobs/{id}, then send the request again."}}}},"ValidationFailed":{"description":"Validation failed","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://neuropage.io/about/documentation/api#validation_failed","title":"Validation failed","status":422,"code":"validation_failed","detail":"A field is invalid, or every lead was rejected. errors[] lists each field.","request_id":"req_76c14c0b4bc4701a148d33ab","hint":"Fix the listed fields and send again."}}}},"RateLimited":{"description":"Rate limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://neuropage.io/about/documentation/api#rate_limited","title":"Rate limited","status":429,"code":"rate_limited","detail":"A limit was reached. The limit field says which one.","request_id":"req_76c14c0b4bc4701a148d33ab","hint":"Wait the Retry-After seconds, then send the same request again."}}},"headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}}}},"InternalError":{"description":"Internal error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://neuropage.io/about/documentation/api#internal_error","title":"Internal error","status":500,"code":"internal_error","detail":"A bug on our side. It is logged with the request_id.","request_id":"req_76c14c0b4bc4701a148d33ab","hint":"Retry once. If it repeats, contact support with the request_id."}}}},"Unavailable":{"description":"Temporarily unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://neuropage.io/about/documentation/api#temporarily_unavailable","title":"Temporarily unavailable","status":503,"code":"temporarily_unavailable","detail":"The API is switched off, or a page could not be started. Any charge was refunded.","request_id":"req_76c14c0b4bc4701a148d33ab","hint":"Wait the Retry-After seconds and send the same request again."}}},"headers":{"Retry-After":{"description":"Seconds to wait before trying again.","schema":{"type":"integer"}}}}}}}