Connectors

Connect your stack. Power your bots.

Integrate any API, database, or webhook with your AI bots. Tools, state sync, and event connectors — all with JSON Schema validation, 7 auth methods, live testing, and automatic prompt wiring.

One integration layer

Tools, state sync, and events in one place. No scattered integrations, no custom middleware — just configure and connect.

Schema-driven safety

JSON Schema v7 validation on every request and response. The LLM only sends what the API expects, and only receives what it can handle.

Auto-wired prompts

Assign a connector to a bot and Rylvo automatically patches its prompt. The LLM learns tool names, parameters, and sync rules instantly.

How it works

Design. Authenticate. Transform. Deploy.

Four stages that take any API from idea to production — with live testing, versioning, and automatic prompt wiring at every step.

The connector pipeline

design → auth → transform → deploy
01

Design

Choose type, define schema, set endpoint

02

Authenticate

7 methods from API key to OAuth2

03

Transform

Shape data between your API and the LLM

04

Deploy

Assign to bots, test live, version and ship

01 · stage

Design

Choose type, define schema, set endpoint

Start by choosing your connector type — Tool, State Sync, or Event. Define the endpoint URL, HTTP method, and timeout. For tools, write the JSON Schema that describes what the LLM can send and what it will receive back.

How it works

  • 3 connector types: Tool, State Sync, and Event
  • JSON Schema v7 for structured input and output validation
  • Per-connector endpoint with method, headers, and timeout override
02 · stage

Authenticate

7 methods from API key to OAuth2

Secure every connection with the right auth method. Choose from None, API Key, Bearer Token, Basic Auth, HMAC-SHA256, OAuth2 Client Credentials, or Custom Headers. Secrets are stored safely and only returned to authorized editors.

How it works

  • 7 auth methods covering every common API security pattern
  • OAuth2 with automatic token refresh and scope management
  • HMAC-SHA256 signatures with timestamp verification
03 · stage

Transform

Shape data between your API and the LLM

Not every API speaks the same language as your LLM. Use request transforms to reshape outgoing payloads and response transforms to clean up what comes back. For state sync, map fields between Rylvo and external systems with patch or replace merge strategies.

How it works

  • Request and response transforms for tool connectors
  • Field mapping and merge strategy for state sync
  • Optional input/output schema enforcement on every call
04 · stage

Deploy

Assign to bots, test live, version and ship

Assign your connector to one or more bots. Rylvo automatically patches each bot's prompt with usage instructions — tool names, parameters, approval gates, and state sync rules. Test the endpoint live from the dashboard, then activate with confidence.

How it works

  • Auto-wired prompts teach the LLM how to use each connector
  • Live HTTP testing with full request/response visibility
  • Every save creates a version snapshot; revert anytime

Connector types

3 types

Tool

Execute actions on external systems. The LLM calls tools by name with structured arguments.

  • JSON Schema input/output
  • Request/response transforms
  • Approval gates
  • Idempotency flags
  • Stage-scoped calling

State Sync

Read and write workflow state to external databases, CRMs, or caches. Keep context in sync across systems.

  • Bidirectional read/write endpoints
  • Patch or replace merge
  • Field mapping
  • Known-facts injection
  • History summary sync

Event

Receive real-time notifications via webhook or polling. Subscribe to workflow events and react instantly.

  • 10 built-in event types
  • Webhook or polling delivery
  • Full payload toggle
  • Configurable batching
  • Per-event filtering

Authentication methods

7 ways to secure every connection.

None

No authentication required

API Key

Header-based API key authentication

Bearer Token

OAuth-style bearer token in Authorization header

Basic Auth

Username and password encoded in Authorization header

HMAC-SHA256

Signed requests with timestamp and shared secret

OAuth2

Client credentials flow with automatic token refresh

Custom Headers

Arbitrary header key/value pairs

Event types

10 events

Decision Completed

A workflow decision finished successfully

Decision Failed

A workflow decision encountered an error

Escalation Triggered

A conversation was escalated to a human

Stage Changed

The conversation moved to a new stage

Tool Executed

A connector tool was called and completed

Tool Failed

A connector tool call returned an error

State Updated

Workflow state was synchronized

Verification Failed

An output verification check did not pass

Session Started

A new user session began

Session Closed

A user session ended

Versioning & live testing

Ship with confidence. Roll back with one click.

Version history

v3current

Added OAuth2 support and batching

2 hours ago

v2

Switched to HMAC-SHA256 auth

Yesterday

v1

Initial connector setup

3 days ago

Live test result

StatusSuccess
HTTP200 OK
Latency127 ms
{
"status": "ok",
"data": { ... }
}

Answers

What teams usually ask

What types of connectors does Rylvo support?

Rylvo supports three connector types: Tool connectors for executing actions on external systems, State Sync connectors for reading and writing workflow state, and Event connectors for receiving webhook or polling-based notifications.

What authentication methods are supported?

Rylvo supports 7 authentication methods: None, API Key, Bearer Token, Basic Auth, HMAC-SHA256, OAuth2 Client Credentials, and Custom Headers.

How does JSON Schema validation work?

Every tool connector defines input and output schemas using JSON Schema v7. Rylvo validates requests before sending them and responses before returning them to the bot. You can also add request and response transforms to reshape data.

What happens when I connect a connector to a bot?

When you assign a connector to a bot, Rylvo automatically patches the bot's prompt with usage instructions. The LLM learns the tool name, description, input parameters, approval requirements, and state sync rules.

Can I test a connector before deploying it?

Yes. The dashboard includes a live test panel that fires real HTTP requests against your endpoint using the current configuration. You see the full response, headers, and latency before saving.

Does Rylvo version connector changes?

Yes. Every save creates a new version snapshot. You can view the full history, see who made each change, read the change notes, and revert to any previous version with one click.

Connect in minutes, not weeks

Your bots are only as powerful as what they can reach.

Start connecting your APIs, databases, and webhooks today. No code required — just configure, test, and deploy.