Medium

About Medium

This repository contains documentation for Medium's OAuth2 API, which allows integrations to publish posts to a user's Medium account on their behalf. It covers authentication (both self-issued access tokens and browser-based OAuth), along with resources for users, publications, posts, and images.

Access requires an access token, obtained either through self-issued integration tokens generated from account settings or through a browser-based OAuth flow using a client ID, client secret, and defined scopes (basicProfile, listPublications, publishPost, uploadImage). Self-issued tokens do not expire but can be revoked by the user.

The Medium API is no longer supported, and the repository is archived and read-only. Medium does not allow any new integrations with the API; browser-based authentication is available only to integrations that already existed prior to this change.

Key features

• Publish posts to a user's Medium account via OAuth2 JSON API
• Self-issued integration tokens for desktop and plugin integrations
• Browser-based OAuth authorization flow for existing integrations
• List a user's publications
• Upload images for use within a Medium post

Frequently asked questions