Connect Sanity

Sanity uses a token issued from your management dashboard. We need write access to one dataset so we can create posts and upload cover images. Quibo auto-detects your schema — it works out of the box with post, article, blogPost, custom names, custom fields. No adapter required.

What you'll need

• Your project ID — visible at sanity.io/manage on the project tile.
• The dataset name — usually production.
• An API token with Editor permission.

Generate a write-scope token

1. Go to sanity.io/manage and pick your project.
2. Open the API tab → Tokens → Add API token.
3. Name it Quibo, choose Editor scope, and copy the token (you'll only see it once).

Plug it into Quibo

From Sites → New pick Sanity and paste:

• Site name (e.g. Acme Blog)
• Site URL — your front-end URL where the article will be visible
• Project ID
• Dataset
• API token

Click Connect site. We validate the token, learn your brand voice, and probe your dataset to discover its post type, body field, fields, and referenced entities (authors, categories).

Auto-discovery (zero config required)

When you connect, Quibo calls Sanity's GROQ API and figures out:

• Post type — from a heuristic candidate list (post, article, blogPost, blog, news, story, entry, page). The first one with at least one document wins. If none match, we fall back to whichever non-system document type has the most rows.
• Body field — the first array-of-blocks field on the post (commonly body or content, but any name works).
• Fields list — full per-field structure derived from sampling up to 100 recent posts. We never write a field name your schema doesn't declare (no orphan fields in Studio).
• Author + category lists — for every reference field on the post, we list the available entities (capped at 200 each) so you can pick the default byline + the agent can choose an existing category instead of creating duplicates.

The first article we publish will use the discovered shape automatically. Open Sites → your site and you'll see a Default author dropdown populated with the authors from your dataset.

What we publish

For each article we create a document of the discovered post type with: title, slug (as {_type:"slug"}), language, meta title and description, excerpt, cover image (uploaded as a Sanity asset and referenced), portable-text body, FAQ array (with _key on each item), category reference, author reference, structured data JSON, and an AI-assisted flag — but only for the fields your schema actually declares.

Custom Quibo nodes like faqBlock are filtered out of the body before serialization, so they never appear as orphan inline objects in Studio.

Test the connection

In Sites → your site click Test connection to confirm the token is valid and the dataset is reachable.

Revoking access

Delete the token from sanity.io/manage at any time. The next attempted publish will fail and the site will be marked as error. You can issue a new token and paste it back into the site's settings.