Integration Tools

Tools for extending Storyblok with webhooks, custom extensions, and field plugins.

Overview

Integration tools help you connect and extend Storyblok:

Webhooks - HTTP callbacks for content events
Extensions - Custom UI apps and integrations
Field Plugins - Custom field types for components

Total tools: 17 (Webhooks: 5, Extensions: 7, Field Plugins: 5)

Webhooks (5 tools)

Set up HTTP callbacks that trigger when content changes.

Listing Webhooks

retrieve_multiple_webhooks

Purpose: Get all webhooks in your space.

Common conversation examples:

Show me all webhooks

Key parameters:

page, per_page - Pagination

Returns: Array of webhook objects.

retrieve_single_webhook

Purpose: Get details of a specific webhook.

Key parameters:

webhook_endpoint_id - Webhook ID (required)

Returns: Single webhook object.

Creating Webhooks

add_webhook

Purpose: Create a new webhook.

Common conversation examples:

Create a webhook that posts to https://api.example.com/notify
when stories are published

Key parameters:

name - Webhook name (required)
endpoint - URL endpoint (required)
actions - Trigger events array (required)
description, secret, activated - Configuration

Common actions:

story.published, story.unpublished
story.deleted, story.moved

Returns: Newly created webhook object.

Updating Webhooks

update_webhook

Purpose: Update webhook configuration.

Key parameters:

webhook_endpoint_id - Webhook to update (required)
name, endpoint, actions - Updated settings

Returns: Updated webhook object.

Deleting Webhooks

delete_webhook

Purpose: Delete a webhook.

Key parameters:

webhook_endpoint_id - Webhook to delete (required)

Returns: Deletion confirmation.

Extensions (7 tools)

Custom applications that extend Storyblok's functionality.

Listing Extensions

retrieve_all_extensions

Purpose: Get all extensions.

Common conversation examples:

Show me all organization extensions

Key parameters:

context - "org" or "partner" (required)

Returns: Array of extension objects.

retrieve_extension

Purpose: Get details of a specific extension.

Key parameters:

extension_id - Extension ID (required)
context - "org" or "partner" (required)

Returns: Single extension object.

Creating Extensions

create_extension

Purpose: Create a new extension.

Key parameters:

name, slug - Basic info (required)
context - "org" or "partner" (required)
embedded_app_url, field_type_ids - Configuration

Returns: Newly created extension object.

Field Plugins (5 tools)

Custom field types for component schemas.

Listing Field Plugins

retrieve_field_plugins

Purpose: Get all field plugins.

Common conversation examples:

Show me all custom field plugins

Key parameters:

context - "space", "org", or "partner"
only_mine - Filter to your plugins
page, per_page - Pagination
search - Search filter

Returns: Array of field plugin objects.

retrieve_field_plugin

Purpose: Get details of a specific field plugin.

Key parameters:

field_type_id - Plugin ID (required)
context - "space", "org", or "partner"

Returns: Single field plugin object.

Need help with integrations? Check out the Storyblok documentation for detailed integration guides!