Skip to main content

Documentation Index

Fetch the complete documentation index at: https://authsome.mbajaj.me/llms.txt

Use this file to discover all available pages before exploring further.

Authsome ships with definitions for the providers below. They are loaded lazily from JSON files inside the package and can be overridden by dropping a file with the same name into ~/.authsome/providers/. For anything not listed here, see Custom providers.

​
OAuth2 providers

ProviderDisplay nameDefault flowHost
atlassianAtlassianpkceapi.atlassian.com
discordDiscordpkcediscord.com
githubGitHubpkceapi.github.com
gitlabGitLabpkcegitlab.com
googleGooglepkceregex:.*googleapis.*
hubspotHubSpotpkceapi.hubapi.com
klaviyo-oauthKlaviyo (OAuth)pkcea.klaviyo.com
linearLineardcr_pkceapi.linear.app
microsoftMicrosoftpkcegraph.microsoft.com
notionNotionpkceapi.notion.com
postizPostizdevice_codeapi.postiz.com
slackSlackpkceslack.com
xX (Twitter)pkceapi.twitter.com

​
API-key providers

ProviderDisplay nameHost
ahrefsAhrefsapi.ahrefs.com
apolloApolloapi.apollo.io
ashbyAshbyapi.ashbyhq.com
beehiivBeehiivapi.beehiiv.com
brevoBrevoapi.brevo.com
bufferBufferapi.bufferapp.com
calendlyCalendlyapi.calendly.com
clearbitClearbitapi.clearbit.com
dubDub.coapi.dub.co
g2G2api.g2.com
hunterHunterapi.hunter.io
instantlyInstantlyapi.instantly.ai
intercomIntercomapi.intercom.io
keywords-everywhereKeywords Everywhereapi.keywordseverywhere.com
klaviyoKlaviyoa.klaviyo.com
lemlistLemlistapi.lemlist.com
livestormLivestormapi.livestorm.co
mailchimpMailchimpapi.mailchimp.com
mention-meMention Memention-me.com
openaiOpenAIapi.openai.com
optimizelyOptimizelyapi.optimizely.com
postmarkPostmarkapi.postmarkapp.com
resendResendapi.resend.com
rewardfulRewardfulapi.getrewardful.com
savvycalSavvyCalapi.savvycal.com
semrushSEMrushapi.semrush.com
sendgridSendGridapi.sendgrid.com
toltToltapi.tolt.com
typeformTypeformapi.typeform.com
wistiaWistiaapi.wistia.com
zapierZapierapi.zapier.com

​
Inspect a definition

To see the full JSON for any bundled provider, including endpoints, scopes, and export map: 
authsome inspect github
authsome inspect openai --json

​
Override a bundled provider

To change a bundled definition — add scopes, point at a self-hosted instance, swap the host URL — copy the JSON to ~/.authsome/providers/<name>.json and edit it. Custom providers always win over bundled ones with the same name. 
authsome inspect github > ~/.authsome/providers/github.json
# edit the file
authsome list   # github now shows source=custom
See Provider registry for the resolution rules.

​
Add a new bundled provider

Bundled providers live in src/authsome/auth/bundled_providers/ inside the authsome source tree. To add one upstream, open a pull request against manojbajaj95/authsome with:
  • The provider JSON in src/authsome/auth/bundled_providers/<name>.json.
  • A test in tests/auth/providers/ confirming the JSON parses against the schema.
  • An update to this page.
For a one-off provider you just need locally, register it as a custom provider — no source tree change required. See Custom providers.