Skip to main content

​
About Gong

Gong is a revenue intelligence platform that captures and analyzes customer interactions across calls, emails, and web conferences. It provides insights into deal progression, coaching opportunities, and market trends to help revenue teams close more deals.

​
What the Gong integration enables

CapabilityDescription
Workflow AutomationBuild Serval workflows to automate anything accessible via Gong’s REST APIs
All resources exposed by the Gong API are available to Serval workflows using API key authentication.

Key Features

  • Access call recordings and transcripts
  • Retrieve deal and opportunity data
  • Manage users and permissions
  • Analyze conversation insights

Common Use Cases

  • Sync call data with CRM systems
  • Automated deal risk alerts
  • Coaching workflow triggers based on call metrics
  • Customer interaction reporting

​
Gong configuration (in Gong)

​
Prerequisites

Before configuring the Gong integration in Serval, ensure you have:
  • Technical Administrator access to your Gong account
  • Permissions to manage API keys in Gong settings

​
Generate API credentials

1

Navigate to API settings

  1. Log in to your Gong account as a Technical Administrator
  2. Click settings in the bottom left to enter the Admin Center
  3. Navigate to Ecosystem → API
  4. Click Get API Key
If you don’t see the API option, your Gong plan may not include API access, or you may need Technical Administrator permissions.
2

Copy your credentials

Gong provides two values:
CredentialDescription
Access KeyThe public part of your API credential
Access Key SecretThe private part of your API credential
Store both credentials securely. You’ll need them to configure the integration in Serval. If you lose the secret, you’ll need to regenerate a new API key pair.
3

Note your API Base URL

Your Gong API Base URL is displayed on the API settings page. It follows the pattern:
https://XX-00000.api.gong.io/
where XX-00000 is your unique Gong instance identifier. You’ll need this URL when configuring the integration.

​
Serval configuration

Once you have your Gong API credentials, follow these steps to configure the integration in Serval:
1

Navigate to Gong integration

  1. In Serval, go to Applications → Available → Gong
  2. Click Connect
  3. The Gong configuration form will appear
2

Enter configuration details

Fill in the following fields:
FieldDescriptionExample
API Base URLYour Gong API base URLhttps://XX-00000.api.gong.io/
Access KeyYour Gong API access keyyour-access-key
Secret KeyYour Gong API secret key••••••••••••••••••••
Serval automatically combines your Access Key and Secret Key into a Base64-encoded Basic Authentication header. Just enter the raw credentials as provided by Gong.
3

Submit the configuration

  1. Click Submit to complete the integration setup
  2. Serval will verify the connection by making a test API request
  3. Once verified, you can start building workflows with Gong

​
How authentication works

Gong uses Basic Access Authentication. When Serval makes API requests to Gong on your behalf, it:
  1. Combines your Access Key and Secret Key as ACCESS_KEY:SECRET_KEY
  2. Base64 encodes the combined string
  3. Sends the header: Authorization: Basic <encoded-credentials>
This is handled automatically by Serval—you only need to provide the raw credentials during setup.

​
Using Gong in workflows

Once connected, you can use Gong in your Serval workflows to automate revenue intelligence processes:
  • Calls: List calls, retrieve call details, transcripts, and recordings
  • Users: Manage users, retrieve user activity and stats
  • Deals: Access deal data and pipeline information
  • Meetings: Retrieve scheduled and completed meetings
  • Stats: Pull interaction stats and analytics
  • Library: Access Gong’s call library and folders
The Gong integration provides access to all endpoints in the Gong API. Explore the API documentation to discover all available capabilities.

​
Troubleshooting

If you receive authentication errors:
  • Verify the Access Key and Secret Key are correct
  • Ensure the API key hasn’t been revoked or regenerated
  • Check that your API Base URL matches your Gong instance
  • Confirm your Gong plan includes API access
If requests fail with permission errors:
  • Verify the API key was created by a Technical Administrator
  • Check that the requested resource is accessible with your permissions
  • Consult the Gong API documentation for required permissions per endpoint
If connections fail:
  • Ensure you’ve included the full URL with protocol (e.g., https://XX-00000.api.gong.io/)
  • Check that the instance identifier matches your Gong account
  • Try accessing the URL directly in a browser to confirm it’s correct

​
Additional Resources

Gong API Documentation

Complete API reference and guides for Gong

Gong Developer Portal

Manage API keys and access settings
Need help? Contact support@serval.com for assistance with your Gong integration.