Skip to main content

​
Overview

Medium is a publishing platform for articles and stories. When posting to Medium, you can set article metadata, tags, and publication options.

​
Settings Schema

{
  "__type": "medium",
  "title": "Article Title",
  "subtitle": "Article Subtitle",
  "canonical": "https://original-url.com/article",
  "publication": "publication-id",
  "tags": [
    { "value": "programming", "label": "Programming" }
  ]
}

​
Properties

PropertyTypeRequiredDescription
__typestring✅Must be "medium"
titlestring✅Article title (min 2 chars)
subtitlestring✅Article subtitle (min 2 chars)
canonicalstring❌Original URL for SEO (canonical link)
publicationstring❌Publication ID to post to
tagsarray❌Up to 4 tags
tags[].valuestring✅Tag identifier
tags[].labelstring✅Tag display name

​
Example

{
  "type": "schedule",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-medium-integration-id"
      },
      "value": [
        {
          "content": "# Introduction\n\nThis is my article content written in markdown.\n\n## Section 1\n\nMore content here...",
          "image": []
        }
      ],
      "settings": {
        "__type": "medium",
        "title": "Building Modern Web Applications",
        "subtitle": "A comprehensive guide to full-stack development",
        "tags": [
          { "value": "programming", "label": "Programming" },
          { "value": "webdev", "label": "Web Development" },
          { "value": "javascript", "label": "JavaScript" }
        ]
      }
    }
  ]
}

​
Notes

  • Article content should be written in Markdown format
  • Maximum of 4 tags allowed
  • If you have a publication, use the publication field to post directly to it
  • Use canonical if the article was originally published elsewhere