API Connectors

Overview

API Connectors are Jeanette's most powerful integration feature. Rather than requiring pre-built integrations for every service, Jeanette can research an API's documentation, build the integration herself, and use it — all within a single conversation.

You provide your API credentials. Jeanette does the rest.

How it works

1. You point Jeanette at the API — share the docs URL or paste the key details.
2. Jeanette reads the documentation — she uses her web browsing tool to read endpoint specs, authentication requirements, and request formats.
3. Jeanette builds the connector — she creates the endpoint definitions and stores them against your account.
4. Jeanette uses the connector — the new endpoints are immediately available as tools in this and future conversations.

Example: connecting Notion

You: Can you connect to my Notion workspace? Here are the API docs: developers.notion.com. My API token is secret_abc123.

Jeanette: Reading the Notion API docs...

Built your Notion connector. I've set up endpoints for: reading pages, creating pages, searching databases, and creating database items. Your credentials are stored securely.

What would you like to do in Notion?

You: Add a task to my Q2 Goals database — "Launch the landing page".

Jeanette: Done — "Launch the landing page" added to your Q2 Goals database.

Supported authentication types

Jeanette supports all common API authentication patterns:

Type	How it works
Bearer token	Authorization: Bearer <token> header
API key header	Custom header (e.g. X-API-Key: <key>)
API key query param	Appended to the URL (e.g. ?api_key=<key>)
Custom header	Any custom header name and value

Credential security

Your API credentials are encrypted at rest using AES-256-GCM. They are stored per connector per user and never shared.

Managing connectors

Listing connectors

You: What connectors do I have set up?

Jeanette: You have 3 connectors: Notion (active), Contentful (active), and Shopify (active). All credentials are valid.

Adding endpoints

If you need Jeanette to do something new with an existing connector, just ask — she'll research and add the endpoint:

You: Can you also update existing Notion pages? You've only got create so far.

Jeanette: Reading the Notion API docs for the update endpoint... Done. I've added an "Update page" endpoint to your Notion connector.

Removing a connector

You: Remove the Shopify connector — I don't use it anymore.

Jeanette: Removed. Your Shopify connector and credentials have been deleted.

Error handling

If an API call fails, Jeanette interprets the error response and adapts:

• Authentication errors — asks you to provide fresh credentials
• Rate limits — waits and retries automatically
• Malformed requests — reads the error, fixes the request, and retries
• Persistent errors — escalates to support with full context

Example services

Connectors can be built for any service with a REST API, including:

• CMS — Contentful, Sanity, WordPress, Webflow
• Project management — Notion, Airtable, Linear, Asana
• E-commerce — Shopify, WooCommerce, Stripe
• Communication — Slack, Discord, Intercom
• Data — Airtable, Google Sheets (via API), Supabase
• Custom internal APIs — your own services with any REST endpoint

Connectors in scheduled tasks

Once a connector is set up, it's available in all your scheduled tasks. For example:

You: Every morning at 8am, check my Shopify store for new orders and send me a summary.