- List calls in a date range and display their metadata
- Retrieve call transcripts
- Read rich call details, including participants, topics, and tracker matches
- Read interaction and activity stats for calls and reps
- Look up Gong users and workspaces
Common use cases and example apps
Use Gong when your app needs the content or the outcomes of customer calls alongside its existing workflows.How to connect Gong
Who can create Gong connections depends on your plan and workspace settings. See Who can create connections and clients. App + chat connectors are available by default on Free, Pro, and Business plans. On Enterprise plans, they are effectively disabled at first: Who can create connections and clients defaults to No one until an admin changes it in Connectors → Admin settings → App + chat connectors. You can create multiple Gong connections using different access keys, which is useful for separating Gong accounts or permission sets. When the connection is created, you can link it to the projects where you want to use it. Anyone building in a project can ask Lovable in chat to link their project to it.Prerequisites
Before connecting Gong, make sure you have:- A Gong account with permission to create API keys
- A Gong access key and access key secret with the permissions your app needs
- Permission to create connections in your Lovable workspace (see Who can create connections and clients)
API requests through this connector count toward Gong’s API limits and any applicable Gong plan usage. Billing and quota are handled directly by Gong, not Lovable.
Step 1: Create a Gong access key
A Gong access key lets your Lovable app authenticate with the Gong API. Gong issues it as a pair: an access key and an access key secret. You need both. To create a Gong access key:1
Open the Gong API page
Sign in to Gong and go to API authentication, under Company Settings → Ecosystem → API.
2
Create an access key
Create a new access key and select only the permissions your app needs.
3
Copy both values
Copy the access key and the access key secret, and store them securely. Gong only shows the secret once.
4
Note your API base URL
Check the API base URL shown on the same page. If it is not
https://api.gong.io, your account is on a regional Gong cell and you need this value in the next step.Step 2: Connect Gong to Lovable
Open the connection form and enter the credentials you created in Gong.1
Open Gong in Connectors
Open Connectors and select Gong. See Where to find connectors for other ways to open the connector catalog.
2
Add a connection
Click Add connection.
3
Configure the connection
- Display name: name the connection, for example
Gong Sales. This name is only used inside Lovable to identify the connection. - Access key: paste the Gong access key.
- Access key secret: paste the secret Gong showed when you created the key.
- API base URL (advanced, optional): leave this empty to use
https://api.gong.io. Fill it in only if Gong showed a regional base URL, for examplehttps://us-11211.api.gong.io.
4
Choose who can use this connection
Under Who can use this connection, decide who in your workspace can use the connection. You start as the only person with access:
- Only you (default): leave the access list as is; only you can use the connection and its associated data.
- Invite specific people: add workspace members by email; only you and the people you add can use the connection and its associated data.
- Invite entire workspace: click Invite entire workspace to make the connection available to everyone in your Lovable workspace.
5
Connect
Click Connect. Lovable verifies the credentials with Gong before saving the connection.
Available data
Through the Gong connector, your app can access the conversation data that the connected access key is allowed to read.
When prompting Lovable, mention what you need and over what period. For example:
Limitations
The Gong connector uses one shared credential pair and keeps requests behind Lovable’s server-side gateway.- Each connection uses one Gong access key, which authenticates as a single Gong company. The connector does not support per-end-user Gong login.
- The connected access key controls what data the app can read and change. Lovable cannot grant permissions that the key does not have.
- Lovable does not rotate Gong access keys automatically. To rotate a key, create a new key in Gong and update the Lovable connection.
- Calls must run through Lovable’s server-side connector gateway. Do not call
api.gong.iodirectly from browser code or expose the access key secret in generated app code. - Gong returns results in pages of up to 100 records, so reads over long date ranges take several requests.
- Call media links that Gong returns expire, so your app should fetch them when needed instead of storing them.
Troubleshooting
Use the Gong response status to identify credential, permission, and rate-limit problems.- A
401response usually means the access key or secret is wrong or has been revoked. Check that both values come from the same key pair, then create a replacement key in Gong and update the connection. - A
403response means the key does not have permission for that endpoint. Create or update a key with the required Gong permissions. Retrying the same request does not fix a missing permission. - A
404response on every request usually means the wrong API base URL. If your Gong account is on a regional cell, set API base URL on the connection to the value Gong shows on its API page. - Gong applies rate limits, by default 3 calls per second and 10,000 calls per day. Cache repeated reads and honor
429responses and theRetry-Afterheader. - Gong rejects bare dates. Send datetimes in ISO 8601 format with a timezone, for example
2026-01-01T00:00:00Z.
Manage your connection
Connections are managed from Connectors: select , then open the connection.- Unlink projects to remove access from specific projects while keeping the connection available for others. See Unlink projects from a connection for the steps.
- Delete the connection to remove it from the workspace entirely. Deleting is permanent. It removes the credentials from all linked projects, and app features that use stop working until a new connection is added. See Delete a connection for the steps and who can delete.