Create a custom connector

1. 1

   Go to the Connectors page, click Add custom in the top right, and choose Custom connector.

   This opens the setup form where you define your new service integration.

2. 2

   Enter a Display name, short summary, description, and pick a category under Details.

   Your team will see these details in the catalog, and the display name sets a permanent internal identifier.

3. 3

   Select your authentication method under Authentication.

   This tells Lovable how to attach security credentials like tokens or keys when making requests.

4. 4

   Enter the secure web address (starting with https://) in API base URL and set a test check under Test request.

   Lovable needs the root address and a verification path (like GET /v1/me) to confirm credentials work when someone connects.

5. 5

   Add an Agent knowledge file with a name, description, and Markdown instructions outlining main paths and request formats.

   Without instructions, Lovable has to guess how to format requests, query data, and handle responses.

6. 6

   Click Create, then find your connector in the catalog and select Connect to enter your credentials.

   Creating the connector adds it to the catalog, but you must establish an active connection before your apps can make requests.

Connect this project to our custom connector. Use the endpoints and formatting documented in the connector's knowledge files to fetch our data and display it in a clean table with filtering.

REST API

A standardized way for two different computer programs to talk to each other over the web.

Endpoint

A specific web address on a service where your app sends or asks for a particular piece of data.

Base URL

The starting root web address shared by all requests sent to that service.

OAuth 2.0

A secure sign-in process where a service opens a pop-up asking permission instead of making you paste an account password.

Bearer token

A secure digital passkey included in a request header that proves you have permission to access the service.

• Never paste real passwords, API keys, or tokens into the knowledge files; credentials are typed only when creating an active connection and are stored encrypted.
• The connector's internal ID is permanently created from your first Display Name and cannot be changed later.
• You cannot edit the authentication method or credential fields while any active connections exist in your workspace.
• Deleting a custom connector immediately erases all associated connections and credentials, permanently breaking any apps that rely on them.
• If using OAuth 2.0, you must copy Lovable's exact redirect URL into your external app provider settings or users will be unable to log in.