Integrations
Sanity
Publish articles to your Sanity.io content lake as structured documents using the Sanity client API.
Prerequisites
- A Sanity.io project with a dataset configured
- A document type for blog posts (default:
post)
Step-by-step setup
- In your Sanity project, go to Manage → Settings → API → Tokens
- Click Add API Token
- Name it (e.g. "Outclimb") and set the permission to Editor (write scope)
- Copy the generated token
- Note your Project ID (visible in the project settings URL and dashboard)
- In Outclimb, go to Settings → Integrations and select Sanity
- Enter your Project ID, Dataset (usually
production), API Token, and Document Type - Click Test Connection, then Save
Required fields
| Field | Description |
|---|---|
| Project ID | Your Sanity project ID, e.g. abc123de |
| Dataset | The dataset name, typically production |
| API Token | A write-scoped API token |
| Document Type | The schema type for blog posts (default: post) |
What gets published
- Title and slug fields
- Body — Portable Text blocks converted from the article HTML
- Excerpt
- SEO metadata — stored in a meta object if your schema supports it
- Categories/Tags — as references if your schema has them
Troubleshooting
403 Forbidden / Insufficient permissions
The API token must have Editor (write) scope. Viewer or read-only tokens cannot create documents. Re-create the token with the correct scope.
Wrong dataset
If articles don't appear in your studio, check that the dataset name matches exactly. Most projects use production, but some use custom names.
Custom document types
If your blog schema uses a type other than post (e.g. article or blogPost), enter that type name in the Document Type field. The document type must exist in your Sanity schema.