List OAuth providers

List the vendors you can connect with OAuth, what each one can be connected as, and whether it runs in mock mode.

GEThttps://api.tried.com.au/oauth/providers

Needs keys Real OAuth needs a client ID and secret for each vendor on the server (<VENDOR>_OAUTH_CLIENT_ID and <VENDOR>_OAUTH_CLIENT_SECRET). Without them a built-in mock OAuth provider issues tokens, and connections made with those tokens stay in mock mode.

Returns the OAuth providers Tried supports for integration apps, CRM connections and knowledge base sync. Use it before Start OAuth to check which target a provider accepts and which options it requires.

Request#

This endpoint takes no path, query or body parameters.

Example request#

curl https://api.tried.com.au/oauth/providers \
  -H "Authorization: Bearer $TRIED_API_KEY"

const res = await fetch("https://api.tried.com.au/oauth/providers", {
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const providers = await res.json();

import os, requests

res = requests.get(
    "https://api.tried.com.au/oauth/providers",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
providers = res.json()

Response#

200 OK

[
  { "provider": "hubspot", "mock": false, "pkce": false, "requires": [], "redirect_uri": "https://api.tried.com.au/oauth/callback", "targets": ["crm", "app"] },
  { "provider": "salesforce", "mock": false, "pkce": true, "requires": [], "redirect_uri": "https://api.tried.com.au/oauth/callback", "targets": ["crm", "app"] },
  { "provider": "dynamics365", "mock": true, "pkce": true, "requires": ["instance_url"], "redirect_uri": "https://api.tried.com.au/oauth/callback", "targets": ["crm", "app"] },
  { "provider": "zoho", "mock": true, "pkce": false, "requires": [], "redirect_uri": "https://api.tried.com.au/oauth/callback", "targets": ["crm", "app"] },
  { "provider": "gohighlevel", "mock": true, "pkce": false, "requires": [], "redirect_uri": "https://api.tried.com.au/oauth/callback", "targets": ["crm", "app"] },
  { "provider": "cal_com", "mock": true, "pkce": true, "requires": [], "redirect_uri": "https://api.tried.com.au/oauth/callback", "targets": ["app"] },
  { "provider": "google_drive", "mock": true, "pkce": true, "requires": [], "redirect_uri": "https://api.tried.com.au/oauth/callback", "targets": ["kb_sync"] },
  { "provider": "onedrive", "mock": true, "pkce": true, "requires": [], "redirect_uri": "https://api.tried.com.au/oauth/callback", "targets": ["kb_sync"] },
  { "provider": "notion", "mock": true, "pkce": false, "requires": [], "redirect_uri": "https://api.tried.com.au/oauth/callback", "targets": ["kb_sync"] }
]

Field	Type	Description
`provider`	string	Value for `provider` in Start OAuth.
`mock`	boolean	`true` when the server has no client ID for this vendor, or runs with `TRIED_MOCK_PROVIDERS=1`.
`pkce`	boolean	Whether the flow uses PKCE (S256) with the vendor. The mock provider always uses it.
`requires`	string[]	Keys that must be set in `options` when you start the flow. Dynamics 365 needs `instance_url`.
`redirect_uri`	string	Callback URL to register in the vendor's OAuth app.
`targets`	string[]	What the provider can connect: `crm` (a CRM connection), `app` (an integration app) or `kb_sync` (a knowledge base synced source).

Errors#

Status	When
`401`	Missing or invalid API key.
`403`	The key's IP allowlist or scopes reject the request. This route needs the `admin` scope.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.