Agility CMS Integration: Publish AI-Optimized Content to Agility from Cleversearch

Seamlessly push AI-optimized content to your headless CMS with custom field mapping

Agility CMS is a headless content management system trusted by enterprise teams for its flexibility in managing structured content across multiple channels. With Cleversearch's Agility CMS integration, you can publish AI-optimized content directly to your Agility instance with full control over content model mapping and publishing workflows.

This integration is designed for teams using Agility as their headless CMS who want to streamline content creation with AI-powered generation and optimization.

Why Connect Agility CMS to Cleversearch?

Headless CMS platforms like Agility give teams maximum flexibility in how content is structured and delivered. But this flexibility also means more configuration is needed when integrating with content generation tools.

Cleversearch's Agility integration provides:

• Custom content model support: Map Cleversearch content to any Agility content model and field structure
• Flexible publishing workflows: Choose between Draft, Publish, or Request Approval workflows
• OAuth authorization: Secure publishing access through Agility's OAuth flow
• Multi-locale support: Publish content in your configured Agility locale
• Field-level mapping: Map each content role (title, body, excerpt, SEO fields) to your specific Agility fields

How to Set Up the Agility CMS Integration

Step 1: Gather Your Agility Credentials

You need the following from your Agility CMS instance:

• Instance GUID: Found in your Agility dashboard under Settings
• API Key: Your Fetch or Preview API key
• Region: US or Canada (where your instance is hosted)
• API Type: Fetch (published content) or Preview (draft content)
• Locale: Your default content locale (e.g., en-us)

Step 2: Connect in Cleversearch

1. Navigate to your site's Integrations page
2. Find the Agility CMS card in the Platforms section
3. Enter your credentials and click Connect
4. Cleversearch validates the connection and fetches your content models

Step 3: Authorize Publishing (OAuth)

After the initial connection, you need to authorize Cleversearch to publish content to your Agility instance:

1. Click Authorize Publishing in the Agility integration card
2. Complete the OAuth flow in the popup window
3. Once authorized, Cleversearch can create and update content in your Agility instance

This two-step process ensures that read access (for fetching models) and write access (for publishing) are separately authorized.

Step 4: Select Your Content Model

Cleversearch displays all available content models from your Agility instance. Select the model you want to publish to — typically a blog post or article model.

Step 5: Map Your Fields

Map Cleversearch content roles to your Agility content model fields:

| Content Role | Description | Example Agility Field | |-------------|-------------|---------------------| | Title | Article title | Title (Text) | | Slug | URL-friendly identifier | Slug (Text) | | Body | Main article content | Content (HTML) | | Excerpt | Short summary | Summary (Text) | | Featured Image | Hero image | Image (Image) | | SEO Title | Meta title for search engines | MetaTitle (Text) | | SEO Description | Meta description | MetaDescription (Text) | | Primary Keyword | Target SEO keyword | PrimaryKeyword (Text) | | Tags | Content categorization | Tags (Text) |

Step 6: Configure Publishing Behavior

Choose how content should be published:

• Draft: Content is saved as a draft, requiring manual publishing in Agility
• Publish: Content is published immediately and available via your Agility API
• Request Approval: Content enters your approval workflow before publishing

Working with Content Models

One of Agility's strengths is its flexible content modeling. Cleversearch adapts to your content structure rather than forcing a specific schema. After connecting, you can:

• Browse all available content models
• View field definitions for each model
• Test field mapping before publishing
• Switch between content models as needed

Best Practices

• Use the Preview API during setup: Connect with the Preview API type initially to verify field mapping with draft content before switching to live publishing
• Map all available SEO fields: If your content model includes SEO-specific fields, map them to maximize search optimization
• Use Request Approval for teams: If your team has an editorial review process, configure the Request Approval publishing behavior
• Test with a single article first: Publish one test article to verify all fields are mapped correctly before batch publishing

Security

The integration uses OAuth 2.0 for publishing authorization. Your API keys are encrypted at rest and never exposed to client-side code. You can revoke publishing access at any time through your Agility account settings.

Frequently Asked Questions

Can I connect to multiple Agility instances?

Each Cleversearch site connects to one Agility instance. If you manage multiple Agility instances, create separate sites in Cleversearch for each.

Does Cleversearch support Agility's media library?

Featured images and OG images are supported when mapped to Image-type fields in your content model.

What happens if my content model changes?

If you add or remove fields in your Agility content model, update your field mapping in Cleversearch to reflect the changes.

Can I use Cleversearch with Agility's Management API?

Yes. Cleversearch uses Agility's APIs to fetch content model definitions and publish content.

Is the integration compatible with Agility's multi-site setup?

The integration connects to a single Agility instance and locale. Multi-site configurations can be handled by creating separate Cleversearch sites.