Guide
The Integration agent (build mode) helps you create and manage custom connectors that sync data from external HTTP-based APIs into Fibery.
What You Can Do
Create a new connector for an external service
Update or extend an existing connector created by the agent
Troubleshoot and fix errors in a connector
Allow the AI to automatically fix connector errors when they occur
Creating a Connector
Describe what you want to integrate and the agent will handle the rest:
"Create a connector for the Linear API. I want to sync Issues and Projects. Auth is via API key."
"Build a connector for our internal REST API at https://api.example.com. It uses Bearer token auth."
The agent will:
Ask clarifying questions if needed (auth method, entity types, filters)
Search the web to verify current API documentation
Generate the connector code and test each function
Save the connector
Add connector to Fibery integrations gallery
After saving, the connector appears in your Fibery integration gallery and is ready to use.
Connector Structure
Each connector is a JavaScript configuration object stored in the database and served as an HTTP app.
Function | Required | Description |
|---|
validateFunction
| Yes | Validates user credentials; returns account display name |
configFunction
| Yes | Returns available entity types and filter definitions |
schemaFunction
| Yes | Returns field schema for selected entity types |
dataFunction
| Yes | Fetches paginated data items to synchronize |
datalistFunction
| No | Provides dynamic dropdown options for filters |
resourceFunction
| No | Downloads authenticated files referenced in synced data |
utilityFunctions
| No | Shared helper functions (e.g. apiGet, formatDate) available to all other functions |
Connector Metadata Fields
Field | Type | Description |
|---|
name
| string
| Display name ([a-zA-Z ]+ only) |
description
| string
| Short description of the integration |
logo
| string
| Inline SVG for the app icon |
authentication
| AuthenticationConfig[]
| Credential fields shown when user connects an account |
allowAiAutoFixCode
| boolean
| Enables automatic error recovery (default: false) |
Viewing and Modifying Connector Code
Each connector has a link to its code editor in the Fibery UI, where you can view and manually edit all functions directly in the browser.
You can also ask the agent to show you the implementation at any time:
"Show me the code for my Linear connector."
"Display the dataFunction of the Todist connector."
The agent will retrieve the connector's functions — validateFunction, schemaFunction, dataFunction, and any utility functions — so you can review exactly what logic runs during synchronization.
Once you've seen the code, you can ask for targeted changes in plain language:
"Add pagination support to the dataFunction — the API returns a nextCursor field."
"The auth header is wrong. It should be X-API-Key, not Authorization: Bearer."
The agent applies the change, shows you the updated code, and saves the new version. You can also paste in an error and ask the agent to adjust the connector accordingly.
Reference the connector by name or ask the agent to list your connectors first:
"Show me my connectors."
"Add a filter to the Todoist connector so users can select which projects to sync."
Fixing Errors
If a connector starts failing, the agent can diagnose and fix it, since every connector created by AI has errors log.
Manual troubleshooting:
"My Todoist connector is failing. Can you check the error log?"
"The Stripe connector's dataFunction is throwing errors. Fix it."
The agent will:
Call displayErrorsLog to retrieve recent errors grouped by function
Search the web if an API change may be responsible
Update the connector with a fix
Automatic error fixing:
You can allow the AI to fix connector errors automatically without being asked each time. When a connector function fails, the system will attempt one AI-driven fix before surfacing the error.
To enable this, ask:
"Enable automatic AI fixes for my Todoist connector."
The agent will ask for your confirmation before enabling it. You can also disable it at any time:
"Turn off auto-fix for the Todoist connector."
Auto-fix also can be enabled via Connector Editor UI:
When auto-fix is active and a function fails, the AI will:
Analyze the error and the failing function
Search for updated API documentation if relevant
Apply a fix and retry the function
Refuse to fix if the error is not a code problem (expired token, invalid credentials, external API outage, etc.)
Auto-fix is disabled by default and requires explicit consent to turn on.
Auto-fix scope
Auto-fix only addresses code-level bugs (incorrect API paths, wrong field mappings, parsing errors, etc.). It will refuse to fix errors caused by:
Expired or revoked API tokens
Invalid credentials
External API outages or rate limits
Any issue outside the connector's own code
Limitations
HTTP/HTTPS only
The agent can only create connectors for services that expose an HTTP or HTTPS API.
It cannot connect to:
Databases directly (PostgreSQL, MySQL, MongoDB, etc.)
File systems or local services
Non-HTTP protocols (JDBC, SMTP, FTP, WebSocket, etc.)
Authentication
Supported authentication methods:
No authentication (public APIs)
API key or token (passed as a header or query parameter)
Basic authentication (username + password)
OAuth is not supported. If the API you want to integrate requires OAuth, the connector cannot be created by agent.