Documentation index for AI agents (llms.txt)
Skip to main content

Connectors

A connector links a service you already use, like Stripe, Supabase or GitHub, to WebTwizz. You connect an account once and it's saved to your connectors. From then on, any of your projects can use it, and a project only gets the connectors you pick for it.

When a project uses a connector:

  • The service's keys are saved as the project's secrets, so your site's code can use them.
  • Anything your site needs to load for it, like an analytics tag or a chat window, goes into your project's code for you. See Code in your project.
  • The builder shows the service's own data for that project: revenue, errors, visitors, commits.
  • The AI can read the service while it works, and set it up for you.

Some connectors add nothing to your site. They let the AI work in another app while it builds, like reading a Notion page or a Linear issue. See Apps the AI can use.

Where connectors live​

Your connectors, in the dashboard​

Click Connectors in the dashboard sidebar, under Library. This page holds every account you've connected, across all your projects.

The Connectors page banner: Connect once. Use it in every project.
  • Connected lists the services you have an account for and the projects using each one. Click one to open it.
  • Add a connector lists everything else. Click a service to connect it.
  • Search, or narrow the list with Connected, All or a category on the left.
  • Need a service that isn't here? Click Request a connector.
Connected accounts with the projects using them, and the connectors not added yet

You can also find a connector by name from Search (⌘K / Ctrl+K) in the dashboard.

A connector's page lists your Accounts for it and the Projects using each one, with that project's settings in place. Open jumps into the project, and Remove takes the connector out of that project.

The GitHub connector page with one account and the two projects using it

What a project uses, in Settings​

In the builder, open Settings and choose Connectors.

  • In this project lists what the project uses. Click one to open it.
  • Add to this project lists everything else. Click a service to add it. If you already connected an account for it, the service shows Uses your and the account's name, and one click adds it with that account.
  • All your connectors opens the dashboard page.
Settings, Connectors in a project: five connectors in this project and seven more to add

Connect a service​

Some services connect by signing in. Others take a key you paste.

HowConnectors
Sign inStripe, GitHub, Sentry, PostHog, Google Analytics, Google Sheets, Google Calendar, Google Search Console, Supabase, Resend, OpenRouter, and the apps the AI can use
Paste a keyOpenAI, Anthropic, Gemini, Groq, Loops, Intercom (an App ID), Cal.com, ElevenLabs, HubSpot, Twilio, WhatsApp, Razorpay, Paystack, PayPal, MCP server

Some offer both: Paste keys for Stripe, Paste a measurement ID for Google Analytics, and Paste a key for Resend and OpenRouter.

From a project:

  1. Open Settings > Connectors and click the service.
  2. Click Connect.
    • Sign-in services open the service in a new window. Approve access there and you come back to the connector.
    • Key services open the page where you make the key, in a window of its own. Copy the key there and come back: WebTwizz picks it up from your clipboard, checks it and connects. Your browser may ask to allow pasting once. You can also click Paste, or paste the key into the field yourself. A service that needs two values, like an ID and a secret, asks for the next one after the first. If the service rejects a key, you'll see That key was not accepted.
  3. If there's something to pick, like a GitHub repository or a Sentry project, the connector opens on Finish connecting with the picker. Pick one and you're done.
OpenAI in a project, not connected yet, with This project only and Connect

From the dashboard, click a service under Add a connector, or open its page and click Connect. The account is saved without being added to any project. Add it to a project later from that project's Settings > Connectors.

The OpenAI connector page with its API key form open

No AI key yet? The OpenAI, Anthropic, Gemini and Groq forms have Sign in with OpenRouter, which gets you every model in one step. See OpenRouter.

Supabase and Google Sheets are data sources, so their Connect opens the Data panel. A project has one data source at a time. See Data & CMS.

Keep an account to one project​

This project only connects an account that only this project can use. Your other projects won't offer it. It's marked This project only in the project and One project only on the dashboard. Handy for a client's Stripe account or a key you don't want reused.

Inside a connector​

Click a connector under In this project. Next to its name are links that open what this project uses on the service, like Open Stripe or Open Sentry. Below that, from top to bottom:

  • Overview: the service's data for this project, like payments for Stripe, errors for Sentry or pull requests for GitHub. Click a row to see its details in place. Many rows have buttons for the everyday jobs, like Refund a payment, Resolve an error or Merge a pull request, so you rarely need the service's own site. Anything that can't be undone asks first. Show more loads the next part of a list, and tables and tabs open in the Data panel.
  • Account: the account this project uses, and Also used in with your other projects that use it. Manage opens the account in your dashboard connectors. Most key-based accounts also have Replace key.
  • Settings: what this project picks, like the repository, the Sentry project or the AI model. Changes save as you make them.
  • Live site: for connectors that put something on your published site, whether it's Running, waiting for you to Publish to update, or starts After you publish.
  • Remove from this project: click Remove, then Remove from project? to confirm. Its keys come out of this project. Your other projects keep the account.

Each connector's page in these docs shows its overview and settings.

Switch or remove an account​

  • Switch accounts in a project: when you have more than one account for a service, the Account row has Switch account. Its menu lists your other accounts and Connect another account. The project switches over and its keys are replaced.
  • Rename an account: on the dashboard connector page, click the account's name, type, and press Enter.
  • Replace a key: click Replace key on the account and paste the new one. Every project using that key switches to it. Razorpay, PayPal and Intercom don't have it, because their values change together: connect the new ones as another account, then switch.
  • Remove an account everywhere: on the dashboard connector page, click Remove on the account, then Remove plus its name. It's disconnected from every project using it, and anything those sites do with it stops until you connect an account again.

Removing never deletes anything on the service. Your Stripe customers, GitHub repository and Sentry events stay where they are.

If a service stops accepting the saved sign-in, the account shows Needs reconnecting with a Reconnect button. If it needs a permission the account didn't give, the overview says the service needs one more permission, with Connect again.

Where the keys go​

Connectors your site uses add their keys as secrets in Settings > Secrets and keep them up to date. They're listed under From connected services. Your preview uses them right away. Publish again so your live site gets them too. See Secrets.

Each connector's page lists the secrets it adds. Keys that only WebTwizz needs, like a HubSpot service key or a Twilio Auth Token, never go into your site.

Code in your project​

Some connectors need code on every page: Google Analytics and PostHog count visits, Sentry catches errors, HubSpot adds its tracking, Intercom shows its Messenger, and Google Search Console adds the tag that proves the site is yours. WebTwizz keeps all of it in one file in your project, webtwizz-connectors.tsx, and adds it to your site's root layout. Your site's own analytics from Settings > Analytics joins it once the site is published. You don't have to touch it.

  • It updates when you add, change or remove one of these connectors, and every time you publish. A project without it gets it on its next publish.
  • Everything except the Intercom Messenger only runs on your published site, so your own visits and errors in the preview don't count. The Messenger shows in the preview too, so you can try it.
  • It's part of your code, so it goes to GitHub and into downloads like any other file. WebTwizz manages it, so changes you make to it by hand are replaced. Change the connector's settings instead.
  • If your site's code already loads one of these services itself, WebTwizz leaves it out of the file, so it never loads twice.

Connectors in the chat​

The AI knows which connectors the project uses and works with them for you.

Connect cards​

When you ask for something that needs a service, like a contact form that emails you, the AI adds a connect card for it, like Connect Resend. Click it to connect without leaving the chat. If you already have an account for that service, the card offers it by name, plus Connect another Resend account.

A Resend connect card offering a saved account and Connect another Resend account

For a service that isn't a connector, the AI adds the secrets it needs to Settings > Secrets without values, so you can paste them in under Needs a value.

Live cards​

Ask how something is doing and the AI can answer with a service's live card: one row per service with the main number, Settings and Open, and details that expand. The numbers come straight from the service, so the AI never retypes or guesses them.

Live Stripe and Google Analytics cards in the chat

The AI reading a service​

The AI reads your connected services when it helps: the errors in Sentry before it fixes one, last month's visitors from Google Analytics, whether your Resend domain is verified. Each read shows as a row in the chat with the service's logo, like Using Linear. While it works, the logo pulses.

A Google Analytics row reading visitors, still working

When it's done, the row says what it found. Click it to see the details.

To point the AI at a service yourself, type @ in the chat box and pick it under Connectors. Type / and open one of the apps the AI can use under MCP to pick one of its tools.

It asks before changing things​

Reads happen on their own. A change to your account on the service asks first, with Accept and Reject: marking a Sentry error resolved, refunding a payment, or changing Supabase sign-in settings. Test emails from Resend and Loops only go to your own inbox, so they don't ask.

The AI reads three Sentry errors, fixes the top one, then asks before marking it resolved

In Chat mode the AI can read connectors but can't change anything through them. The one exception is apps the AI can use and MCP servers: a tool that might change something asks you first, and runs only if you accept.

GitHub and Stripe have tools of their own: the AI works with your repository through git, and with your Stripe account through its Stripe tool. Your site's data goes through the Data panel's tools. Each connector page says what the AI can do with it.

All connectors​

Data​

ConnectorWhat it's forHow you connect
WebTwizz CloudDatabase, sign-ins, file storage, jobs and logsIncluded. The AI adds it, or add it from the Data panel
SupabaseDatabase and sign-ins in your own Supabase accountSign in, from the Data panel
Google SheetsA spreadsheet as your site's dataSign in with Google, from the Data panel

Payments​

ConnectorWhat it's forHow you connect
StripePayments and subscriptionsSign in, or paste keys
RazorpayPayments in India: UPI, cards and netbankingPaste a Key ID and Key Secret
PaystackPayments in Nigeria, Ghana, Kenya and morePaste a secret key and public key
PayPalPayPal and card payments worldwidePaste a client ID and secret

Analytics​

ConnectorWhat it's forHow you connect
Google AnalyticsWho visits your siteSign in with Google, or paste a measurement ID
Google Search ConsoleHow your site does in Google searchSign in with Google
PostHogWhat visitors do, with replays and feature flagsSign in
SentryCatch and fix errorsSign in

Email​

ConnectorWhat it's forHow you connect
ResendEmails from your own domainSign in, or paste an API key
LoopsMailing lists and emails for your usersPaste an API key
KlaviyoLets the AI see your email marketing resultsSign in

Support, CRM and messaging​

ConnectorWhat it's forHow you connect
IntercomLive chat on every pagePaste an App ID
HubSpotYour site's leads in HubSpotPaste a service key
TwilioText messages and phone sign-in codesPaste your Account SID and Auth Token
WhatsAppWhatsApp messages from your business numberPaste a token and IDs

Booking and voice​

ConnectorWhat it's forHow you connect
Cal.comLet visitors book time with youPaste an API key
Google CalendarBookings straight into your calendarSign in with Google
CalendlyLets the AI find your booking linksSign in
ElevenLabsA voice agent visitors can talk toPaste an API key

AI​

ConnectorWhat it's forHow you connect
OpenAIGPT models in your sitePaste an API key
AnthropicClaude in your sitePaste an API key
GeminiGemini models in your sitePaste an API key
OpenRouterHundreds of models with one accountSign in, or paste an API key
GroqVery fast open modelsPaste an API key

Code​

ConnectorWhat it's forHow you connect
GitHubYour code in your own repositorySign in

Apps the AI can use​

These let the AI work in another app while it builds. Nothing is added to your site, and they're free on every plan. See Apps the AI can use for each one.

Notion, Linear, Cloudflare, Zapier, Make, monday.com, ClickUp, Miro, Webflow, Wix, Klaviyo, Calendly, Todoist, Context7, Exa, Firecrawl, Hugging Face, Microsoft Learn, and any other service through an MCP server.