Schedule social posts from your own code: Marky for TypeScript, Python and n8n

Your app, your CRM or your blog already knows what to post. Now it can post it. We just shipped three official ways to drive Marky from code:

• TypeScript and JavaScript: npm install mymarky
• Python: pip install mymarky
• n8n: the n8n-nodes-marky community node. No code needed.

Write a caption, add a photo, pick a time. Marky posts it to every account you connected.

Who it's for

• Agencies who want to post for every client from one script. One API key works for every workspace in your account.
• Developers who want their own app or website to schedule posts.
• n8n users who want posts to go out on their own when something happens, like a new blog post.

TypeScript: schedule a post with a photo

npm install mymarky

Node 20 or newer. Here is a full example. It finds your workspace, adds a photo from a link, then creates and schedules the post:

import { Marky } from "mymarky";

const marky = new Marky({ apiKey: process.env.MARKY_API_KEY! });

// Each business or client is a workspace
const { items: workspaces } = await marky.listWorkspaces();
const workspaceId = workspaces[0]!.id;

// Add a photo from a link
const media = await marky.uploadMediaFromUrl({
  workspace_id: workspaceId,
  url: "https://example.com/storefront.jpg",
});

// Create the post and schedule it in one call
const post = await marky.createPost(workspaceId, {
  caption: "We're open late this Friday!",
  media_ids: [media.id],
  status: "SCHEDULED",
  scheduled_publish_time: "2030-01-01T09:00:00Z",
});

Every other part of the API is there too, with types, on marky.client.

Python: the same thing in Python

pip install mymarky

Python 3.11 or newer. Each API call is a function you import. Pass client=marky.client to it:

from datetime import datetime, timezone

from mymarky import Marky
from mymarky.generated.api.businesses import list_workspaces
from mymarky.generated.api.posts import create_post
from mymarky.generated.models import PostCreateRequest

with Marky(api_key="mk_live_...") as marky:
    workspace = next(marky.paginate(list_workspaces.sync))
    post = create_post.sync(
        workspace.id,
        client=marky.client,
        body=PostCreateRequest(
            caption="We're open late this Friday!",
            status="SCHEDULED",
            scheduled_publish_time=datetime(2030, 1, 1, 9, 0, tzinfo=timezone.utc),
        ),
    )

Every call has a normal and an asyncio version.

n8n: post without writing code

1. In n8n, go to Settings > Community Nodes > Install.
2. Type n8n-nodes-marky and install it.
3. Add a Marky API credential with your API key (it starts with mk_live_).

You get two new nodes. Marky can:

• Create a post, as a draft or already scheduled
• Schedule a post you made before
• Add a photo or video from a link
• List your workspaces, connected accounts and posts

Marky Trigger starts your workflow each time a post goes live.

What you can automate

• New blog post, new social post. An RSS trigger sees your new article. Marky creates the post and schedules it.
• A week of posts, every week. A Schedule trigger runs on Monday and loops over your ideas. Each one becomes a scheduled post.
• Tell your team when a post is live. Marky Trigger fires when a post goes out. Send it to Slack, email or a Google Sheet.

Turn on n8n's Retry On Fail without worry. A retry never makes a second post.

Get told when a post goes live

Set up a webhook and Marky calls your server each time a post goes out. One line checks that the call really came from Marky:

import express from "express";
import { Marky, constructEvent } from "mymarky";

const marky = new Marky({ apiKey: process.env.MARKY_API_KEY! });
const app = express();

// Ask Marky to call you when a post goes live
await marky.createWebhook({
  url: "https://example.com/marky-webhook",
  events: ["post.published"],
});

// Check the call is really from Marky, then use it
app.post("/marky-webhook", express.raw({ type: "application/json" }), (req, res) => {
  const event = constructEvent(req.body, req.headers, process.env.WEBHOOK_SECRET!);
  console.log("Live:", event.post_id);
  res.sendStatus(200);
});

In Python it is construct_event(raw_body, request.headers, secret).

The boring parts are done for you

• No double posts. If a call fails, it tries again only when that is safe. A retry gets back the first post, not a new one.
• Slow down when asked. If you send too much at once, it waits and tries again.
• Clear errors. Each error has a name, like NotFoundError or RateLimitError, so your code knows what went wrong.
• No surprise changes. Each version is locked to the API it was built for. Your code keeps working when we update the API.

The SDKs are built from the same public API spec as our API docs. So every call in the docs is in the SDKs too.

Get started

1. Open Organization Settings > API Keys and create a key. You need to be an org admin.
2. Install the package for your tool.
3. Schedule your first post.

The API is free while it is in beta.

• SDK guide
• n8n guide
• mymarky on npm · mymarky on PyPI · n8n-nodes-marky on npm

Questions? Reach out in the chat. We'd love to see what you build.