Why Connect Strapi?
Content Search
Chatbot can search and retrieve Strapi content
Knowledge Base Sync
Automatically sync Strapi content to your knowledge base
Flexible Content Types
Works with custom content types and collections
API Token Auth
Secure authentication with API tokens
Prerequisites
- Strapi 4.x or 5.x project
- Admin access to your Strapi dashboard
- API Token generated from your Strapi admin
- Content API permissions configured
Setup Steps
1
Navigate to Integrations
Go to Dashboard → Integrations and find the Strapi card
2
Click Connect
Click Connect Strapi to open the connection form
3
Enter API URL
Enter your Strapi API URL (e.g.,
https://cms.yoursite.com/api)4
Generate API Token
Create an API Token in your Strapi admin:
- Log in to your Strapi admin dashboard
- Go to Settings → Global Settings → API Tokens
- Click Create new API Token
- Enter a name (e.g., “BubblaV Integration”)
- Set token duration (recommended: Unlimited or long duration)
- Set token type to Read-only or Full access
- Click Save
- Copy the generated API Token (shown only once)
5
Configure Content Permissions
Ensure your API Token has access to the content types you want to sync:
- Go to Settings → Users & Permissions → Roles → Public
- Or create a dedicated role for the integration
- Enable find and findOne permissions for desired content types
6
Enter Credentials
Enter your API Token in the connection form
7
Verify Connection
Click Connect. The Strapi card should now show Connected
Available Tools After Connection
| Tool | What It Does | Example Query |
|---|---|---|
strapi_search_content | Search Strapi content types | ”Find articles about pricing” |
strapi_sync_knowledge_base | Sync content to knowledge base | Syncs your Strapi content automatically |
Test Your Integration
Try these queries on your website:- “What do you have about [topic]?”
- “Show me articles about [subject]”
- “Find content related to [keyword]“
Troubleshooting
Authentication fails
Authentication fails
- Verify your API Token is correct
- Check that the token hasn’t expired
- Ensure the token type is set correctly (Read-only or Full access)
- Make sure you’re including the full token without spaces
Connection fails
Connection fails
- Verify your API URL is correct and accessible
- Check that Strapi is running and the API is available
- Ensure your site is not blocking API requests
- Try accessing
/api/articles(or another endpoint) to test API availability
Content not syncing
Content not syncing
- Wait a few minutes for the initial sync to complete
- Check that your content types have published entries
- Verify that the Public role (or your custom role) has find/findOne permissions
- Check that content types are set to be publicly accessible
Permission errors
Permission errors
- Strapi uses role-based permissions for API access
- By default, the Public role has limited access
- You may need to create a dedicated role with proper permissions
- Ensure the API Token is associated with a role that has read permissions
Custom content types
Custom content types
- The integration works with any Strapi content type
- Custom fields and components are supported
- Ensure your content types have API enabled in their settings
- Check that the content schema is properly configured
Security: We use Strapi API Tokens for authentication. These tokens can be revoked or regenerated at any time from your Strapi admin without affecting your application.
