The door is closed
Most setup guides end with a working channel. This one probably will not, and it is better that you hear it here than after twenty minutes of hunting through Medium settings for a token that does not exist any more. Medium says it plainly in its own help center, on the API and importing page:Medium will not be issuing any new integration tokens for our API and will not allow any new integrations. However, all existing tokens will continue to work.Medium’s own API documentation opens on the same note: “The Medium API is no longer supported. We do not recommend using it.”
What she can post to Medium
For the people who kept a token, nothing about the connector changed. She takes a title, a Markdown body and up to four topics, and sends the article either to your own profile or to a publication you belong to. Where it goes decides what state it lands in, which is the part worth reading twice.Character limit
100,000 characters. The editor is Markdown.
Media
No cover picture field on this connector. Pictures ride inside the Markdown body.
Post types
One article, to your profile or to a publication. A title, a subtitle and topics, with a canonical link if you want one.
Analytics
None. Ten connectors report numbers back to her, and Medium is not one of them.
The Subtitle field is required before she will accept the post, and it is not part of what she sends to Medium. Fill it for the composer’s sake. What reaches Medium is the title, the body and the topics, plus a canonical link when you set one.
Set up Medium
1
Find your existing integration token
Look through your Medium account settings for an integration token issued before Medium closed the API. If one is listed, copy it.If nothing is listed, stop here. Medium is not issuing new ones, and there is no substitute credential this connector accepts.
2
Add Medium as a channel
In PostQueen, click Add Channel and pick Medium. A modal titled Add Provider opens with a single field:
Press Connect. She calls
https://api.medium.com/v1/me with the token as a bearer credential, and the channel appears with your Medium name and picture.3
Write the first article
Open a new post, select the Medium channel and fill the settings panel:
- Title: required, at least two characters.
- Subtitle: required by the form, not sent to Medium.
- Canonical Link: optional, for a piece published elsewhere first.
- Select publication: optional, and it changes where the article lands and in what state.
- Topics: optional, up to three in the composer. The API accepts a fourth.
The channel is in the left sidebar with its avatar and name. That is the whole confirmation: if it is in the list, she can post to it.
Troubleshooting
- “API key is invalid” in the connect modal: the field rejects anything under three characters. Paste the whole token.
- “Invalid credentials” after pressing Connect: Medium did not accept the token. On an account with no pre-existing token, this is the expected answer, and no amount of retrying changes it.
- The article is a draft on Medium: you selected a publication. Clear the publication field to publish to your own profile instead.
- No publication picker in the settings panel: she found no publications on your account, so there is nothing to choose and every article goes to your profile.