> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skayle.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connectors Overview

> Connect Skayle to your CMS, control sync behavior, and publish from one workflow.

## What connectors do

Connectors let Skayle publish posts into your CMS while keeping taxonomy and author data aligned with your workflow.

## Supported connectors

External connectors:

* WordPress
* Sanity
* Webflow
* Contentful

Built-in mode:

* Skayle CMS (headless mode)

## Connectors and APIs are different

Skayle supports three related but distinct flows:

| Flow                   | Direction                                          | Purpose                                                      |
| ---------------------- | -------------------------------------------------- | ------------------------------------------------------------ |
| External CMS connector | Skayle → WordPress, Sanity, Webflow, or Contentful | Push managed content into an external CMS                    |
| Skayle CMS Content API | Skayle → your website or application               | Retrieve content from `/v1/{organizationId}`                 |
| Agent API and MCP      | AI client or automation ↔ Skayle                   | Authenticated management and control through `/mcp` or `/v2` |

The public CMS Content API is available only in **Skayle CMS** mode. External
connector organizations receive their content through the connected CMS
instead.

The Agent API and MCP work across both models. They can manage Skayle content
and, with the required scope and confirmation, invoke the configured publishing
workflow without revealing stored connector credentials.

## Draft vs publish behavior

Across connectors, Skayle keeps a draft-first workflow.

* Draft: content exists in Skayle and can be edited.
* Publish: content is pushed to the connector using connector-specific status behavior.
* Unpublish: content is moved back to draft in Skayle and unpublish/remove behavior follows connector support.

## Field mapping

Mapping controls how Skayle post fields map to CMS fields.

* WordPress uses fixed WordPress API fields.
* Sanity, Webflow, and Contentful require explicit field mapping.

Correct mapping is required for stable publish and update behavior.

## Taxonomy sync logic

Taxonomy sync supports categories, tags, and authors with connector-specific capabilities.

You can run sync flows based on your selected source of truth:

* Skayle as source of truth
* Connector as source of truth

## If publishing fails

When publish fails, Skayle surfaces a user-visible error message so you can resolve configuration issues and retry.

Common causes include:

* Invalid credentials
* Missing CMS permissions
* Incomplete field or taxonomy mapping
* CMS-side validation conflicts

## Setup tutorials

Use a connector-specific guide:

* [WordPress Setup](/connectors/wordpress)
* [Sanity Setup](/connectors/sanity)
* [Webflow Setup](/connectors/webflow)
* [Contentful Setup](/connectors/contentful)