Custom Connector Creation

How it works

A custom connector teaches your workspace to call any REST API, public or internal. You define it once and everyone in the workspace can connect to it like a built-in connector.

1. 01

   An admin or owner creates it

   Open Connectors, select +, then Custom connector. Creating one needs the workspace admin or owner role and is available on all plans. It is visible only in that workspace.

2. 02

   Describe the API

   Give it a display name, short description, category and optional docs link. The internal ID comes from the display name and cannot be changed later.

3. 03

   Pick how the API takes credentials

   Bearer token, an API key in a header or query parameter, basic auth, several fields under Advanced, or OAuth 2.0. You never enter credential values here. Each user adds their own when they connect.

4. 04

   Set the base URL and a test request

   The base URL must start with https://. The test request, such as GET /v1/me, is what Lovable calls to check credentials when someone connects.

5. 05

   Add knowledge files

   Write the key endpoints, example requests, response shapes, pagination and rate limits in Markdown. Leave out keys and login steps. Up to 50 files, 50,000 characters each, 256 KB in total.

6. 06

   Connect, share and build

   Members select Add connection, enter credentials, and choose who can use it. New connections are private by default. Credentials are stored encrypted and added to requests on the server, never in chat or code.

Deleting a custom connector also deletes every connection to it, including stored credentials, and apps using those connections stop working. It cannot be undone. A connector cannot switch between OAuth 2.0 and key-based login after it is created.

Estimate what your connector will cost to run

Creating a custom connector is available on every plan, and Lovable's guide lists no fee per call. What you pay for is the API itself. Take the price from your provider's pricing page and enter it here.

Check your knowledge files fit

Fits. About 9% of the 256 KB limit for the whole connector.

The atlas does not know your provider's prices. Building the connector into an app still uses your normal Lovable credits. Characters are counted as roughly one byte each, so text with many special characters takes more room.

Example workflows

Runs worth copying verbatim. Each prompt is written the way it should be sent, as one paragraph with the outcome and the constraints stated up front.

1. 01

   Write the knowledge file for your API

   You have created the connector and need the knowledge file that stops Lovable guessing endpoint paths and field names.

   Read the API documentation at [paste your API docs URL] and write a connector knowledge file in Markdown for a Lovable custom connector. Start with a one-line summary of what the API does, then list the key endpoints with method, path relative to the base URL and what each does, then give request examples as code blocks for the three most common operations, then describe the response wrapper and field names, then a notes section covering pagination, rate limits, versioning, and date and ID formats. Do not include any API keys, tokens, login steps or marketing copy, and keep it under 50,000 characters.

   Expected outcome

   A knowledge file to paste into Agent knowledge. Check its length against the calculator below before you save.

2. 02

   Build a feature on the connected API

   The connector exists, you have added a connection, and you want an app feature that uses it.

   Use my [connector name] connector to add a page that lists the latest 20 records from the API, newest first, with a search box and a detail view. Follow the connector's knowledge file for endpoints and pagination, keep every API call on the server, and show a clear message if the API rate limits us or the connection fails. When it works, tell me how many API calls one page load makes so I can estimate the monthly cost.

   Expected outcome

   A working page and a calls-per-page-load figure to enter in the calculator below with your provider's price.

Frequently asked

• What is Custom Connector Creation?

  Custom Connector Creation is Lovable's Integrations feature: Create a connector for any API. Workspace admins and owners can now create custom connectors for any REST API, enhancing the integrations available for their projects and allowing for personalized API connections based on project needs.

• Is Custom Connector Creation GA or in beta?

  Custom Connector Creation is generally available (GA) on Lovable.

• What Lovable plan includes Custom Connector Creation?

  Custom Connector Creation is available on all Lovable plans.

• When did Custom Connector Creation launch?

  Custom Connector Creation launched on Aug 31, 2026.