Skip to main content
POST
/
api
/
posts
Create post
curl --request POST \
  --url https://api.mymarky.ai/api/posts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "business_id": "<string>",
  "caption": "<string>",
  "publish_to": [],
  "media_urls": [
    "<string>"
  ],
  "status": "NEW",
  "adhoc_publish_time": "2023-11-07T05:31:56Z"
}
'
{
  "id": "<string>",
  "business_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "caption": "<string>",
  "status": "<string>",
  "media_urls": [
    "<string>"
  ],
  "publish_to": [
    "<string>"
  ],
  "adhoc_publish_time": "2023-11-07T05:31:56Z",
  "published_at": "2023-11-07T05:31:56Z",
  "publish_results": [
    {
      "platform": "<string>",
      "status": "<string>",
      "publish_id": "<string>",
      "post_url": "<string>",
      "error_type": "<string>",
      "error_message": "<string>",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "updated_at": "2023-11-07T05:31:56Z"
}

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.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
business_id
string
required

UUID of the business to create the post for

​
caption
string
required

Post caption text

​
publish_to
enum<string>[] | null

Target platforms (e.g. instagram, facebook, linkedIn)

Available options:
facebook,
instagram,
twitter,
linkedIn,
linkedInProfile,
tiktok,
pinterest,
googleBusiness,
instagramStory,
youtube
​
media_urls
string[] | null

URLs to images or videos to attach

​
status
enum<string>
default:NEW

Initial post status

Available options:
NEW,
SCHEDULED
​
adhoc_publish_time
string<date-time> | null

Schedule time (required if status is SCHEDULED)

Response

Successful Response

​
id
string
required

Post ID

​
business_id
string
required

Business this post belongs to

​
created_at
string<date-time>
required

When the post was created

​
caption
string | null

Post caption text

​
status
string | null

Post status: NEW, SCHEDULED, PUBLISHED, etc.

​
media_urls
string[] | null

Attached media URLs

​
publish_to
string[] | null

Target platforms

​
adhoc_publish_time
string<date-time> | null

Scheduled publish time

​
published_at
string<date-time> | null

When the post was published

​
publish_results
PublishResultResponse · object[]

Per-platform publish outcomes — one entry per platform this post was sent to. Poll this until every entry has a terminal status (success or failed) to know publishing is complete.

​
updated_at
string<date-time> | null

Last update time