# Medium API For Publishing, Scheduling, And Cross-Posting

Source: https://www.narrareach.com/features/medium-api

Updated: 2026-07-16

Narrareach gives writers and content teams a maintained Medium publishing workflow for drafts, scheduled articles, tags, SEO metadata, and distribution alongside Substack and LinkedIn.

Narrareach lets eligible users create, schedule, and publish Medium stories without obtaining a new Medium integration token. Medium no longer issues new integration tokens or approves new API integrations, so Narrareach maintains the publishing path while the writer keeps control of the visible title, story, tags, timing, and supported search metadata.

## Does Medium still have an API?

Medium has a documented publishing API, but its current help documentation says it no longer issues new integration tokens and does not allow new integrations. Existing integrations may continue to work, while new developers should not design a product around receiving a fresh token.

Medium also supports importing an already published story through its editor. The import tool adds a canonical link to the original source and backdates the Medium story to match the original publication date. That is useful for a one-off migration, but it is different from a repeatable multi-channel publishing system.

Before choosing an approach, identify whether the job is a single import, a native Medium draft, a scheduled story, or an ongoing cross-publishing workflow. Each path has different controls and maintenance requirements.

- Do not promise a new Medium integration token based on an outdated API tutorial.
- Use Medium import when canonicalizing a previously published article is the actual job.
- Use a maintained publishing workflow when Medium is one recurring destination among several.

## How Narrareach publishes and schedules Medium stories

Narrareach connects the writer's Medium account inside the product, then treats Medium as a destination in a reviewed article workflow. A story can begin as a Narrareach draft, a Substack article, an imported article, or an existing piece in the long-form library.

The writer chooses Medium, reviews the Medium-specific version, adds or confirms tags and publication settings, and decides whether the story should remain a draft, publish now, or enter the scheduling queue. Scheduling works even when the writer closes the browser because the queue runs in Narrareach rather than in an open editor tab.

The queue also records whether an item is waiting, published, or needs attention. This makes a failed destination visible without forcing the writer to reconstruct the entire campaign or republish successful destinations.

- Send the first test story as a draft before enabling a recurring workflow.
- Review the selected Medium publication and tags for every new content series.
- Keep the source draft until all intended destinations confirm publication.

## Medium SEO titles, descriptions, tags, and canonical links

Medium separates the visible story title from supported search settings. Narrareach can generate and pass an SEO title and description through supported Medium publishing paths while leaving the visible title and article body unchanged. Medium does not expose the same custom-slug control used by Substack, so Narrareach does not promise a Medium SEO slug.

Tags help Medium classify and recommend the story inside its own network. Narrareach generates or carries tags through both immediate and scheduled publishing paths so scheduling does not silently remove the article context prepared during review.

Canonical links answer a different question: which URL should search engines treat as the original version? If the story first appeared on a site you control, Medium's import workflow can attach that source canonical. Do not assign a canonical merely to force rankings; choose the original version deliberately and verify the rendered Medium settings after publication.

- Keep the SEO title concise and aligned with the search question the article answers.
- Use tags that describe the actual subject rather than unrelated high-volume topics.
- Verify the canonical URL on the published story when another site is the original source.

## Cross-post from Substack to Medium without duplicating the workflow

Cross-posting should preserve the researched article while allowing each destination to present it appropriately. Narrareach keeps one source article and separate destination settings, so a Medium search title, Substack subtitle, LinkedIn commentary, and follow-up Notes do not overwrite one another.

After the long-form versions are queued, the same source can generate reviewed follow-up posts for LinkedIn, Substack Notes, X, Bluesky, Threads, and other supported channels. Those posts should carry one useful idea from the article rather than repeat the same promotional sentence everywhere.

Performance belongs in the same loop. Review the available Medium, newsletter, traffic, and subscriber signals alongside the article, then use the strongest topic or format as evidence for the next draft. Platform metrics remain platform metrics; cross-channel relationships should be labeled as direct attribution only when a tracked source supports that conclusion.

- Keep one source article and edit destination settings independently.
- Schedule follow-up posts after the article URL is available when those posts need a link.
- Use performance signals to choose the next angle instead of automatically reposting every article.

## The publishing workflow

Medium API searches usually come from writers and developers who want to create a draft, publish an article, preserve tags, set search metadata, or move an existing story into Medium without another manual editor session.

Medium still documents its API and importing behavior, but it no longer issues new integration tokens or allows new integrations. A new project cannot assume that following an old tutorial will produce a working token.

The operational requirement is broader than one request. A reliable workflow has to preserve the article body, platform-specific metadata, tags, images, publication choice, draft or scheduled state, delivery result, and the relationship to versions published elsewhere.

## Sources

- [Medium API and importing documentation](https://help.medium.com/hc/en-us/articles/213480228-API-Importing): Medium's current API availability, integration-token policy, import behavior, and canonical-link guidance.
- [Medium scheduled publishing](https://help.medium.com/hc/en-us/articles/216650227-Schedule-to-publish): Medium's current native scheduling instructions and scheduled-story behavior.

## What you can do

- Medium draft and publish workflows: so articles can move into Medium without manual copy-paste
- SEO metadata support: so Medium can receive a supported search title and description without changing the visible story
- Cross-platform scheduling: so Medium articles can drive follow-up Notes and social posts from the same queue

## Choose the Medium publishing path that fits the job

Native Medium tools, the legacy API, and Narrareach solve different publishing and distribution requirements.

| Capability | Medium native editor | Legacy Medium API | Narrareach |
| --- | --- | --- | --- |
| Write and publish one story | Built in | Supported for existing tokens | Supported in a multi-channel workflow |
| Obtain a new integration token | Not required | No longer issued | Not required from the user |
| Native scheduling | Built in | Application responsibility | Visible Narrareach queue |
| Substack and social distribution | Manual | Separate integrations | Connected supported destinations |
| Search metadata and tags | Manual controls | Payload-dependent | Prepared and reviewed in the article workflow |
| Publishing status and recovery | Medium only | You build it | Queue state and destination attention states |

Medium can change its editor and API behavior. Confirm the current help documentation and test a draft before relying on an automated workflow.

## Make Medium part of your publishing system

Connect Medium and schedule your first article workflow.

[Start free trial](https://www.narrareach.com/sign-up)

[Publish to Medium and Substack](https://www.narrareach.com/features/publish-to-medium-and-substack)

## Questions and answers

### Does Medium still offer an API?

Medium still documents its API, but its current help documentation says it no longer issues new integration tokens and does not allow new integrations. Existing integrations may continue to work; new projects should not assume they can obtain a token.

### Can Narrareach publish or schedule Medium stories?

Yes. Eligible Narrareach users can connect Medium, prepare a Medium-specific version, choose a draft, scheduled, or immediate workflow where available, and monitor the item in the Narrareach queue.

### Can Narrareach cross-post between Medium and Substack?

Yes. Narrareach keeps one source article with separate Medium and Substack destination settings, then supports follow-up Notes and social posts from the same source without forcing every destination to use identical metadata.

### Can Narrareach create a Medium draft instead of publishing immediately?

Yes. The Medium workflow can preserve a draft for review when that option is selected and supported by the connected publishing path. Review the destination state before treating a queued request as published.

### Does Narrareach add tags to scheduled Medium articles?

Yes. Tags are generated or carried with the article publishing data for supported immediate and scheduled Medium paths. The writer should review the tags because relevant classification is more useful than adding broad terms for reach alone.

### Can Medium use a separate SEO title and description?

Medium supports search title and description settings. Narrareach can prepare those fields for eligible users through supported publishing paths while leaving the visible story title and body unchanged.

### Can Narrareach set a custom Medium slug?

No custom Medium slug is promised. Medium and Substack expose different metadata controls: supported Medium workflows use search title and description, while Substack is the destination with the custom article slug workflow.

### How should I handle canonical links when republishing on Medium?

Choose the actual original URL, use Medium's import or canonical controls where appropriate, and verify the published setting. A canonical is a source signal, not a substitute for making the Medium version useful to its readers.
