Skip to main content

create_publication

Schedule or create a new publication across one or multiple social media accounts.

Parameters​

  • project_id (integer, required): Project ID.
  • post_at (string, required): Date and time for publication in ISO 8601 format (e.g., 2025-06-28T15:00:00+03:00).
  • delete_at (string, optional): Scheduled date and time for automatic post deletion.
  • rubric_id (integer, optional): Rubric ID.
  • account_ids (array, required): List of account IDs where the post will be published.
  • publication_status (integer, required): One of the following:
    • 4: draft
    • 5: waiting for publication
    • 10: template
    • 11: workflow stage
    • 12: on approval
  • details (array, required): A list of objects containing publication details.

Details Object​

  • account_id (integer, optional): Specific account ID for these details.
  • publication_type (integer, required): 1 (post), 2 (story), 4 (reels/shorts/clips).
  • content (string, optional): Publication text.
  • comment (string, optional): First comment to the publication.
  • link (string, optional): External link.
  • title (string, optional): Publication title.
  • tiktok_comment (boolean, optional): Allow comments on TikTok.
  • tiktok_duet (boolean, optional): Allow duets on TikTok.
  • tiktok_stitch (boolean, optional): Allow stitch on TikTok.
  • tiktok_privacy_status (integer, optional): TikTok privacy: 1 (public), 2 (friends), 3 (private).
  • youtube_privacy_status (integer, optional): YouTube privacy: 1 (public), 2 (unlisted), 3 (private).
  • x_reply_settings (integer, optional): X reply settings: 1 (everyone), 2 (people you follow), 3 (only people you mention).
  • instagram_share_to_feed (boolean, optional): Share to Instagram feed.
  • instagram_trial_reels_graduation_strategy (integer, optional): Instagram trial reels graduation strategy: 1 (manual), 2 (performance-based).
  • nsfw (boolean, optional): NSFW label (adult content).
  • file_ids (array, optional): List of file IDs.
  • location (object, optional): Geolocation.
    • facebook_id (integer, required)
    • lat (number, required)
    • lng (number, required)
    • name (string, required)
    • description (string, optional)

Example Request​

curl -X POST https://mcp.postmypost.io/mcp \
  -H "Authorization: Bearer <your-api-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "create_publication",
      "arguments": {
        "project_id": 123,
        "post_at": "2025-06-28T15:00:00+03:00",
        "account_ids": [1, 2],
        "publication_status": 5,
        "details": [
          {
            "publication_type": 1,
            "content": "Check out this awesome update!",
            "file_ids": [10293]
          }
        ]
      }
    }
  }'