How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Why is OAuth so hard?

lock Security & Authentication Updated August 12, 2026

Short answer

Because it solves a genuinely hard problem — delegated access without sharing passwords — and because most implementations bolt an application registration and a multi-leg dance onto what the user experiences as "let this thing see my data."

OAuth solves a real and hard problem: how do I let an application act on my behalf without giving it my password? The answer — a scoped, revocable token issued after I explicitly consent — is genuinely the right shape, and the API economy could not function safely without it. When you click “connect your account” and get a screen asking what the app may access, that is OAuth doing its job.

The difficulty comes from everything wrapped around it. Before a developer can get a token, they usually have to register an application, get a client ID and secret, configure redirect URIs, choose a grant type from a menu of options with unhelpful names, and implement a redirect dance — all before making a single call. For a developer that is a frustrating afternoon. For a non-developer who just wants to pull their own data, it is a wall.

The specification also carries genuine flaws and a long history of extensions, deprecated grants, and provider-specific interpretations, which means “we support OAuth 2.0” tells you much less than it should about what you are about to integrate with.

My position has been consistent for years: OAuth has many flaws and it is the best we have. Do not replace it. Do reduce the friction around it — offer personal access tokens for the common case of accessing your own account, document your grant types with working examples, and stop making people register an application to read one endpoint.

Go deeper in the guidance

This answer is distilled from the API Evangelist guidance catalog — the long-form treatment of each topic, with its own citations back into sixteen years of writing.

Read the original writing

The posts on apievangelist.com this answer is built on.

OAuth 101

2013-08-27