Skip to content

Choose an Authentication Type

Not sure which authentication type to use for your connector? Match your external API's requirements to find the right option.

Decision Guide

Your API requires...Use
No authenticationNone
A static API key or tokenAPI Key
OAuth 2.0 client credentials (client ID + secret)OAuth Client Credentials
A self-signed JWT as the bearer tokenJWT
A JWT assertion exchanged for an OAuth access token (e.g. Salesforce)OAuth JWT Bearer

Start Simple

If you are unsure, start with API Key — it covers most third-party APIs. Move to OAuth or JWT when your API provider requires token-based flows.

Common Scenarios

ScenarioRecommended type
Weather API or other public API authenticated with a keyAPI Key
Salesforce integration using client credentialsOAuth Client Credentials or OAuth JWT Bearer
Internal service that validates signed JWTs directlyJWT
Public API with no authentication requiredNone

Next Steps

  • Authentication — Configuration fields and request flow for each type
  • Secrets — Store credentials with get_secret() instead of hardcoding values
  • Testing & Debugging — Verify authentication is working

Gainsight CC Developer Portal