Skip to main content

​
Overview

Coding agents can use the Marky API to generate on-brand posts, create posts, update them, and schedule publishing. Marky can write the copy and make the images for you (pulled from your business’s brand kit), or your agent can supply its own. Either way Marky handles delivery to the social accounts connected in the dashboard.
The easiest way to connect an agent is the MCP server — one URL and your agent gets Marky’s tools natively, no REST cheat-sheet to maintain. The REST examples below still work if you’d rather call the API directly.

​
Claude Code example

Add this to your agent’s instructions or CLAUDE.md: 
## Social media posting

To create and schedule social posts, use the Marky API:

1. List businesses: GET https://api.mymarky.ai/api/businesses
   - Header: Authorization: Bearer mk_live_YOUR_KEY

2. Create post: POST https://api.mymarky.ai/api/businesses/YOUR_BIZ_ID/posts
   - Body: {"caption": "Your post text", "restrict_publish_to": ["instagram", "linkedin"]}

3. Schedule: POST https://api.mymarky.ai/api/businesses/YOUR_BIZ_ID/posts/{post_id}/schedule
   - Body: {"scheduled_publish_time": "2026-12-01T14:00:00Z"}
Then ask your agent: “Create 3 social posts about our new product launch and schedule them for tomorrow at 2pm.”

​
Python script

import httpx
from datetime import datetime, timedelta, timezone

API_KEY = "mk_live_your_key_here"
BIZ_ID = "your-business-id"
BASE = "https://api.mymarky.ai/api"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1. Create a post
resp = httpx.post(f"{BASE}/businesses/{BIZ_ID}/posts", headers=HEADERS, json={
    "caption": "Why consistent social posting matters for small businesses #SmallBusiness",
    "restrict_publish_to": ["instagram", "linkedin"],
})
post = resp.json()

# 2. Schedule it
publish_time = datetime.now(timezone.utc) + timedelta(days=1)
httpx.post(f"{BASE}/businesses/{BIZ_ID}/posts/{post['id']}/schedule", headers=HEADERS, json={
    "scheduled_publish_time": publish_time.isoformat(),
})

​
cURL example

# Create a post
POST_ID=$(curl -s -X POST https://api.mymarky.ai/api/businesses/YOUR_BIZ_ID/posts \
  -H "Authorization: Bearer mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"caption":"Spring sale announcement!","restrict_publish_to":["facebook","instagram"]}' \
  | jq -r '.id')

# Schedule it
curl -s -X POST https://api.mymarky.ai/api/businesses/YOUR_BIZ_ID/posts/$POST_ID/schedule \
  -H "Authorization: Bearer mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scheduled_publish_time":"2026-12-01T14:00:00Z"}'

​
Rate limits

Each API key can make:
  • 100 requests per minute
  • 2,000 requests per day
  • 10,000 requests per week
An agent creating 5 posts and scheduling them uses ~10 requests, well within limits. If you hit a cap, you get a 429 response with a Retry-After header telling you how many seconds to wait. The X-RateLimit-* response headers show how many requests you have left in the current window.

​
Tips

  • Stagger scheduled times. Don’t schedule all posts at the same time. Space them out by 2-4 hours for better engagement.
  • Use the library. Push markdown content into /api/businesses/{business_id}/library/files as context, then reference it when creating posts.
  • Upload images first. Use POST /api/businesses/{business_id}/media to upload images, then attach them to files with POST /api/businesses/{business_id}/files/{id}/media.