Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mymarky.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Try it in the docs

Every API Reference endpoint page includes an interactive playground (Try it / Send). You run the same requests as below against the real API without leaving the docs.
  1. Open the linked reference page for the step you are on.
  2. Under Authorization, choose Bearer and paste your mk_live_… key (the same value you use in curl).
  3. Fill path or body fields if needed, then Send.
Mintlify shows one playground per reference page. Use the Try it cards under each step to jump straight to the matching operation.

​
Prerequisites

  • A Marky account with at least one business set up
  • An API key (create one here)
  • Your business ID (find it in your dashboard URL: app.mymarky.ai/businesses/{business_id})

​
1. List your businesses

Find your business ID:

Try it: List businesses

GET /api/businesses — interactive playground on the reference page.
curl https://api.mymarky.ai/api/businesses \
  -H "Authorization: Bearer mk_live_your_key_here"
Response: 
[
  {
    "id": "your-business-uuid",
    "title": "My Business",
    "description": "A great company",
    "industry": "Marketing",
    "website": "https://mybusiness.com"
  }
]

​
2. Create a post

Push a post into your Marky queue:

Try it: Create post

POST /api/posts — set business_id, caption, and publish_to, then send.
curl -X POST https://api.mymarky.ai/api/posts \
  -H "Authorization: Bearer mk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "business_id": "your-business-uuid",
    "caption": "Exciting news! We just launched our new product line. Each piece is handcrafted with sustainable materials and comes with a lifetime warranty.",
    "publish_to": ["instagram", "linkedin"]
  }'
Response: 
{
  "id": "post-uuid",
  "business_id": "your-business-uuid",
  "caption": "Exciting news! ...",
  "status": "NEW",
  "publish_to": ["instagram", "linkedin"]
}

​
3. Schedule it

Set a publish time and the post goes out automatically:

Try it: Schedule post

POST /api/posts/{post_id}/schedule — use the id from the create-post response as post_id.
curl -X POST https://api.mymarky.ai/api/posts/post-uuid/schedule \
  -H "Authorization: Bearer mk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "publish_at": "2026-04-15T14:00:00Z",
    "publish_to": ["instagram", "linkedin"]
  }'
The post will be published automatically at the scheduled time.

​
4. Set up a webhook (optional)

Get notified when posts are published:

Try it: Register webhook

POST /api/webhooks — register url and events (e.g. post.published).
curl -X POST https://api.mymarky.ai/api/webhooks \
  -H "Authorization: Bearer mk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhook",
    "events": ["post.published"]
  }'
When a post publishes, Marky sends a POST request to your URL with the post payload, signed with HMAC-SHA256 (verify using the X-Marky-Signature header and the secret returned when you registered the webhook).

​
Next steps

Create posts

Full post creation reference

Manage topics

CRUD on topics

Webhooks

Set up event notifications

Integration guides

Connect Claude Code, Zapier, GHL