# Integrations

ClayHog integrates with popular tools and platforms to help you seamlessly incorporate AI search optimization into your existing workflow.

## Available Integrations

### Headless CMS Platforms

Connect ClayHog to your content management system to publish optimized content directly from the Content Creator.

#### Storyblok (Available Now)

**What it does**: Seamlessly publish to your Storyblok space while maintaining your component structure.

**Setup**:

1. Navigate to **Settings > Integrations**  
2. Select **Connect** for Storyblok  
3. Enter your Storyblok space ID  
4. Add your Management API token  
5. Configure field mappings

**Features**:

- Full component support
- Block-based content publishing
- Asset management
- Multi-language support

#### Coming Soon

We’re actively working on integrations with:

**Contentful**  
- Publish directly to your Contentful space  
- Map ClayHog fields to content types  
- Update existing content

**Sanity**  
- Schema-aware publishing  
- Rich text support  
- Reference management

**WordPress**  
- Classic and block editor support  
- Custom post types  
- Category and tag sync

**API Access**  
- We’re building a public API that will allow you to integrate with any CMS or custom system  
- Available on paid plans when released

### Collaboration Tools (Coming Soon)

We’re building integrations with popular collaboration tools to streamline your workflow.

#### Slack

**What it will do**: Receive real-time notifications about your AI visibility directly in Slack channels.

**Planned notifications**:

- New citations detected
- Significant visibility changes
- Competitor movement alerts
- Weekly performance summaries
- Team member activities

**Configuration options**:

- Choose which events trigger notifications
- Select specific channels for different alert types
- Set notification frequency
- Customize message format

#### Zapier

Connect ClayHog to 5,000+ apps through Zapier automation.

**Potential use cases**:

- Trigger workflows when visibility changes
- Create tasks in project management tools
- Send data to analytics platforms
- Automate reporting

## Managing Integrations

### Connecting an Integration

1. Navigate to **Settings > Integrations**  
2. Find the service you want to connect  
3. Click **Connect**  
4. Follow the authorization flow  
5. Configure integration settings

### Disconnecting an Integration

1. Go to **Settings > Integrations**  
2. Find the connected service  
3. Click **Disconnect**  
4. Confirm the disconnection

**Note**: Disconnecting removes access but does not delete previously synced data.

### Troubleshooting Connections

If an integration stops working:

1. **Check permissions**: Ensure ClayHog still has necessary access
2. **Reconnect**: Try disconnecting and reconnecting
3. **Verify credentials**: Make sure API tokens haven’t expired
4. **Review settings**: Check that configuration is correct

## Integration Security

### Permissions

ClayHog requests only the minimum permissions needed:

- **Read access**: To fetch content and settings
- **Write access**: To publish or update content
- **Webhook access**: To receive real-time updates

### Data Handling

All integration data is:

- Encrypted in transit (TLS/SSL)
- Stored securely
- Never shared with third parties
- Removable at any time

### Token Management

API tokens and credentials are:

- Encrypted at rest
- Never logged or exposed
- Automatically refreshed when possible
- Revocable from integration settings

## CMS Publishing Workflow

### Publishing Content

When you publish from ClayHog to your CMS:

1. **Create content** in the Content Creator  
2. **Review and optimize** using ClayHog insights  
3. **Select integration** from the Settings tab  
4. **Map fields** to your CMS structure  
5. **Preview** before publishing  
6. **Publish** with one click

### Field Mapping

Configure how ClayHog content maps to your CMS:

- **Title**: Maps to post title or headline
- **Content**: Maps to body or main content field
- **Meta description**: Maps to SEO description
- **Images**: Upload to CMS media library
- **Tags**: Sync as categories or tags
- **Author**: Assign to CMS users

### Content Sync

After initial setup:

- Changes in ClayHog can update CMS content
- Track which content was published where
- View publication history
- Manage multiple destinations

## Notification Preferences (Coming Soon)

When Slack integration launches, you’ll be able to customize notifications for:

### Visibility Alerts

- Significant increases or decreases in visibility
- Threshold alerts when visibility crosses specific values

### Citation Alerts

- New citations detected
- Citation milestones reached
- Lost citations

### Competitor Alerts

- Competitor visibility changes
- New competitors appearing in results
- Ranking position changes

### Team Activities

- New content published by team members
- Prompt additions
- Settings changes

### Notification Frequency Options

- Real-time alerts for critical changes
- Daily digest summaries
- Weekly comprehensive reports
- Custom schedules

## API Access (Coming Soon)

We’re building a public API that will allow you to build custom integrations.

### Planned API Features

**RESTful API**:

- Retrieve visibility data
- Manage prompts programmatically
- Access citation information
- Query competitor data

**Webhooks**:

- Real-time updates for visibility changes
- New citation notifications
- Competitor movement alerts

**Rate Limits**: API usage will be subject to rate limits based on your plan. See our [pricing page](/content/pricing/index.html) for details when the API becomes available.

## Best Practices

### For Storyblok Integration

1. **Test with draft content** before publishing live
2. **Map fields carefully** to match your Storyblok content types
3. **Keep backup** of content in your CMS
4. **Review published content** after sync to ensure proper formatting
5. **Use component mapping** to maintain your design system

### General Integration Tips

1. **Start with test data** to verify connections work properly
2. **Document your field mappings** for team reference
3. **Monitor integration logs** for any errors or issues
4. **Keep API tokens secure** and rotate them periodically

## Next Steps

- Learn about [content creation workflow](/content/help/content-creator/index.html)
- Explore [account settings](/content/help/account-settings/index.html)
- Understand [billing and plans](/content/help/billing-plans/index.html)