Skip to main content

Transitioning from Insight templates to AI fields in Claap's API and Webhooks

Written by Marta Connor

Claap is revisiting how Insights generated for a recording are being made available as AI fields through the interface, the MCP, the API, and webhooks. The newer AI fields will be available in a flatter structure, outside of any grouping.

⚠️ Starting the 15th of June 2026, the recording insightTemplates attribute will no longer be filled and will be replaced by the aiFields attribute. aiFields will contain the recording insights in a flat collection.

Upcoming changes to Claap's API and webhooks

What currently appears as

"insightTemplates": [
{
"templateTitle": "<string>",
"insights": [
{
"langIso2": "<string>",
"sections": [
{
"description": "<string>",
"title": "<string>"
}
]
}
]
}
]

Will now be available as

"aiFields": [
{
"description": "<string>",
"title": "<string>"
}
]

Enabling the new format in your webhooks

Any new webhook created will have the new format by default.

⚠️ To migrate to the new output format before the 15th of June 2026, update your webhook configuration to enable the new aiFields attribute.

You can choose to toggle this ON/OFF for any webhook by adjusting the setting "Include AI fields in the payload" in the Create/Edit popin. To do this:

  1. Go to Settings > API & Webhooks

  2. Click on "..." for the desired webhook

  3. Click on Edit

  4. Adjust the setting to ON or OFF

💡 When the setting is ON, the webhook payload will contain the aiFields attribute instead of insightTemplates.

Enabling the new format in your API calls

You can choose the output format in your API response by setting the parameter returnAiFields to either true or false.

💡 When returnAiFields in your request is set to true, the API response output will replace the insightTemplates attribute with the new aiFields attribute.

Insight Templates → AI Fields Migration

We've redesigned how Insight Templates work to make them more powerful, easier to manage, and fully compatible with MCP.
If you're looking for your existing Insight Templates after the update, don't worry they haven't been deleted.
They've simply been migrated to the new AI Fields experience.

Where did my Insight Templates go?

Instead of finding them under Folders, you can now access them from the Meetings section.
There you'll find:

  • All of your migrated Insight Templates

  • The AI Fields associated with each template

  • A centralized place to manage, edit, and organize your meeting analyses


What changed?
Insight Templates have evolved into AI Fields.
Rather than managing templates separately, everything now lives alongside your meetings, making it easier to configure, reuse, and analyze the information you care about.
From the Meetings page, you can:

  • View all AI Fields linked to a template

  • Edit or configure AI Fields

  • Create and manage multiple analysis views

  • Organize your workspace more efficiently


Customize your views
You can create and customize different views depending on your workflow.
For example, you might have:

  • SPICED Qualification

  • Sales Coaching

  • Customer Success Reviews

  • Product Feedback

  • Discovery Calls

You can choose which views are displayed and hide the ones you don't need, allowing every team to focus on the insights that matter most.

Available through MCP
The new AI Fields architecture is also fully available through MCP.
Instead of querying individual templates, you can now query an entire view.
For example, you can ask MCP to retrieve the SPICED Scoring view for a meeting, giving you structured insights that can easily be integrated into your own workflows or automations.
This provides a much more flexible way to access meeting intelligence programmatically.

Why we made this change
This migration brings several improvements:

  • A single place to manage all meeting analyses

  • Better organization through customizable views

  • Easier configuration of AI Fields

  • Full compatibility with MCP

  • A more scalable foundation for future AI features

Whether you're working directly in Claap or through MCP, you'll now have a more consistent experience for managing and retrieving meeting insights.

Technical documentation for the new AI fields attribute

Did this answer your question?