Medium Integration
Connect your iContentForge project directly to your Medium account to automate the publishing of AI-generated articles. This integration uses a secure Integration Token to authenticate and allows you to control the publication status of each article.
Generating Your Medium Integration Token
To connect iContentForge, you must first generate an Integration Token from your Medium account settings.
- Log in to your Medium account.
- Navigate to Settings.
- Scroll down to the Security and apps section.
- Under Integration tokens, type a name for your token (e.g., "iContentForge").
- Click Get token. A long string of characters will be generated.
- Copy this token immediately, as it will only be shown once.
Important: Treat your Integration Token like a password. It provides full access to publish and manage posts on your behalf. Store it securely and never share it publicly. If compromised, you can revoke it at any time from the same Medium Settings page.
Medium Settings page showing the Integration tokens section
Connecting iContentForge to Medium
Once you have your token, follow these steps within iContentForge:
- Go to your Project Dashboard and select CMS Integrations.
- Click + Add CMS and choose Medium from the list.
- In the connection modal, paste your Integration Token into the designated field.
- Click Connect. iContentForge will validate the token and link to your Medium account.
You can connect multiple iContentForge projects to the same Medium account using the same Integration Token. Each project will publish articles to your single Medium profile.
Configuring Article Publication Status
When generating articles for Medium, you can define their initial publication state. This is configured in the Article Settings of your project or during the article generation workflow.
You have three options for the publishStatus field:
| Status | Description |
|---|---|
draft | The article is saved to your Medium drafts but not published. You can review and edit it on Medium before manually publishing. |
public | The article is published immediately to your Medium profile and is publicly accessible. |
unlisted | The article is published but cannot be discovered through Medium's recommendations or search. It is only accessible via a direct link. |
Article Field Mapping
iContentForge automatically maps your generated article content to the correct fields in the Medium API. Here is how the data is structured:
| iContentForge Field | Maps to Medium Field | Notes |
|---|---|---|
| Title | title | The main headline of your article. |
| Content (HTML) | content | The full body of your article. iContentForge sends this as formatted HTML, which Medium will render correctly. |
| Tags | tags | An array of topic tags for your post (e.g., ["seo", "content-marketing", "ai"]). |
| Publish Status | publishStatus | Defines the initial state: draft, public, or unlisted. |
| Canonical URL | canonicalUrl | (Optional) If you set a canonical URL in iContentForge, it will be passed to Medium to signal the original source of the content. |
Example API Payload
Below is a simplified example of the data iContentForge sends to the Medium API when publishing an article.
{
"title": "The Future of Programmatic SEO",
"contentFormat": "html",
"content": "<h1>The Future of Programmatic SEO</h1><p>This is the article content in <strong>HTML</strong>...</p>",
"tags": ["seo", "automation", "ai"],
"publishStatus": "public"
}
Managing Published Articles
Once an article's status changes to Published in iContentForge, you can manage it directly within your Medium account:
- Drafts: Found in your Medium drafts list.
- Published/Unlisted Posts: Found in your published stories list.
Articles published via the API will show "Published via API" in their story details on Medium.
Next Steps
- Learn how to schedule content automatically using Drip Feed Publishing.
- Understand the different Article Statuses in iContentForge.
- Explore other available CMS Integrations.