> For the complete documentation index, see [llms.txt](https://doc.duaer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/integrations/builtin/credentials/gong.md).

# Set up Gong credentials in Duaer

Store Gong connection details in Duaer for digital-organization nodes to use at runtime. Secrets are protected by the instance encryption key and are not written into node parameters.
## Choose a Gong credential type <a href="#choose-a-credential-type" id="choose-a-credential-type"></a>

The Duaer Gong node supports two credentials:

- Gong API: a Gong admin opens Company Settings > Ecosystem > API, clicks Create, and puts Access Key and Access Key Secret in the credential. Put the company-specific address shown on that page, such as https://us-12345.api.gong.io, in Base URL.
- Gong OAuth2 API: register an OAuth app in Gong developer settings, set Redirect URI to the Duaer OAuth Redirect URL, put Client ID and Client Secret in the credential, then click Connect my account.

## Gong API <a href="#gong-api" id="gong-api"></a>

In Duaer, choose Gong API when you create a credential, then fill in these fields:

- Base URL: Default: https://api.gong.io.
- Access Key (secret)
- Access Key Secret (secret)

When you save, Duaer tests the connection with these values.

Duaer nodes that use it: [Gong](/integrations/builtin/app-nodes/duaer-nodes-base.gong.md).

## Gong OAuth2 API <a href="#gong-oauth2-api" id="gong-oauth2-api"></a>

In Duaer, choose Gong OAuth2 API when you create a credential, then fill in these fields:

- Client ID (required)
- Client Secret (required, secret)
- Base URL: Default: https://api.gong.io.

Duaer uses the OAuth2 Authorization Code grant for this type.

In the provider’s app settings, register the OAuth Redirect URL that the Duaer credential dialog shows (https://<your-duaer-host>/rest/oauth2-credential/callback). Then click Connect my account in Duaer and approve access.

By default, Duaer requests these scopes: api:calls:read:transcript api:provisioning:read api:workspaces:read api:meetings:user:delete api:crm:get-objects api:data-privacy:delete api:crm:schema api:flows:write api:crm:upload api:meetings:integration:status api:calls:read:extensive api:meetings:user:update api:integration-settings:write api:settings:scorecards:read api:stats:scorecards api:stats:interaction api:stats:user-actions api:crm:integration:delete api:calls:read:basic api:calls:read:media-url api:digital-interactions:write api:crm:integrations:read api:library:read api:data-privacy:read api:users:read api:logs:read api:calls:create api:meetings:user:create api:stats:user-actions:detailed api:settings:trackers:read api:crm:integration:register api:provisioning:read-write api:engagement-data:write api:permission-profile:read api:permission-profile:write api:flows:read api:crm-calls:manual-association:read.

Optional settings shared by every Duaer OAuth2 credential: Ignore SSL Issues (Insecure), Token Expired Status Code, Encrypted Tokens (JWE), JWKS URI. They are described under [OAuth2 API](/integrations/builtin/credentials/httprequest.md#oauth2-api).

Duaer nodes that use it: [Gong](/integrations/builtin/app-nodes/duaer-nodes-base.gong.md).

## Save the connection in Duaer

Open Credentials and create Gong. Fill in the key, OAuth, or server fields. After you save, digital-organization nodes reference this credential instead of putting the secret in a parameter.

Credential values are protected by the instance encryption key. If you change or lose that key, stored credentials cannot be decrypted. See the hosting notes on encryption keys. The matching node is under [the related node](/integrations/builtin/app-nodes/duaer-nodes-base.gong.md).

## Who can use this credential

Who can see or edit it follows projects and roles. Do not paste secrets into chat or variables. External vaults are covered under external secrets.
## Questions

### Do Gong secret values appear in Duaer node parameters?

No. In Duaer, Gong secrets stay in the credential. Nodes only reference the credential. Execution records should not show the plaintext secret either.

### What usually stops a Gong credential from saving in Duaer?

Wrong fields, an OAuth callback that does not match the instance URL, or a role that cannot create credentials. Check the fields Gong expects, then confirm you can create credentials in that project.

