Create Post

POST

api

post

Create or schedule a post across platforms

curl --request POST \
  --url https://mallary.ai/api/v1/post \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": "<string>",
  "platforms": [],
  "profile_id": "AbC123xYz90",
  "media": [
    {
      "url": "<string>",
      "type": "<string>",
      "thumbnail_url": "<string>"
    }
  ],
  "comments_under_post": [
    "<string>"
  ],
  "scheduled_at": "<string>",
  "scheduled_timezone": "<string>",
  "auto_reply_enabled": true,
  "platform_options": {
    "facebook": {
      "message": "<string>",
      "post_type": "feed"
    },
    "instagram": {
      "message": "<string>",
      "post_type": "feed"
    },
    "threads": {
      "message": "<string>"
    },
    "twitter": {
      "message": "<string>"
    },
    "x": {
      "message": "<string>"
    },
    "linkedin": {
      "message": "<string>",
      "author_urn": "<string>"
    },
    "tiktok": {
      "message": "<string>",
      "media_type": "PHOTO",
      "post_mode": "MEDIA_UPLOAD",
      "title": "<string>",
      "description": "<string>",
      "disable_comment": true,
      "disable_duet": true,
      "disable_stitch": true,
      "video_cover_timestamp_ms": 1,
      "auto_add_music": true,
      "brand_content_toggle": true,
      "brand_organic_toggle": true,
      "is_aigc": true,
      "photo_cover_index": 0
    },
    "youtube": {
      "message": "<string>",
      "title": "<string>",
      "visibility": "public",
      "categoryId": "22",
      "madeForKids": false
    },
    "pinterest": {
      "message": "<string>",
      "title": "<string>",
      "boardId": "<string>",
      "link": "<string>",
      "alt_text": "<string>"
    },
    "reddit": {
      "message": "<string>",
      "subreddit": "<string>",
      "subredditName": "<string>"
    },
    "snapchat": {
      "message": "<string>"
    }
  },
  "webhook_url": "<string>"
}
'

import requests

url = "https://mallary.ai/api/v1/post"

payload = {
    "message": "<string>",
    "platforms": [],
    "profile_id": "AbC123xYz90",
    "media": [
        {
            "url": "<string>",
            "type": "<string>",
            "thumbnail_url": "<string>"
        }
    ],
    "comments_under_post": ["<string>"],
    "scheduled_at": "<string>",
    "scheduled_timezone": "<string>",
    "auto_reply_enabled": True,
    "platform_options": {
        "facebook": {
            "message": "<string>",
            "post_type": "feed"
        },
        "instagram": {
            "message": "<string>",
            "post_type": "feed"
        },
        "threads": { "message": "<string>" },
        "twitter": { "message": "<string>" },
        "x": { "message": "<string>" },
        "linkedin": {
            "message": "<string>",
            "author_urn": "<string>"
        },
        "tiktok": {
            "message": "<string>",
            "media_type": "PHOTO",
            "post_mode": "MEDIA_UPLOAD",
            "title": "<string>",
            "description": "<string>",
            "disable_comment": True,
            "disable_duet": True,
            "disable_stitch": True,
            "video_cover_timestamp_ms": 1,
            "auto_add_music": True,
            "brand_content_toggle": True,
            "brand_organic_toggle": True,
            "is_aigc": True,
            "photo_cover_index": 0
        },
        "youtube": {
            "message": "<string>",
            "title": "<string>",
            "visibility": "public",
            "categoryId": "22",
            "madeForKids": False
        },
        "pinterest": {
            "message": "<string>",
            "title": "<string>",
            "boardId": "<string>",
            "link": "<string>",
            "alt_text": "<string>"
        },
        "reddit": {
            "message": "<string>",
            "subreddit": "<string>",
            "subredditName": "<string>"
        },
        "snapchat": { "message": "<string>" }
    },
    "webhook_url": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    message: '<string>',
    platforms: [],
    profile_id: 'AbC123xYz90',
    media: [{url: '<string>', type: '<string>', thumbnail_url: '<string>'}],
    comments_under_post: ['<string>'],
    scheduled_at: '<string>',
    scheduled_timezone: '<string>',
    auto_reply_enabled: true,
    platform_options: {
      facebook: {message: '<string>', post_type: 'feed'},
      instagram: {message: '<string>', post_type: 'feed'},
      threads: {message: '<string>'},
      twitter: {message: '<string>'},
      x: {message: '<string>'},
      linkedin: {message: '<string>', author_urn: '<string>'},
      tiktok: {
        message: '<string>',
        media_type: 'PHOTO',
        post_mode: 'MEDIA_UPLOAD',
        title: '<string>',
        description: '<string>',
        disable_comment: true,
        disable_duet: true,
        disable_stitch: true,
        video_cover_timestamp_ms: 1,
        auto_add_music: true,
        brand_content_toggle: true,
        brand_organic_toggle: true,
        is_aigc: true,
        photo_cover_index: 0
      },
      youtube: {
        message: '<string>',
        title: '<string>',
        visibility: 'public',
        categoryId: '22',
        madeForKids: false
      },
      pinterest: {
        message: '<string>',
        title: '<string>',
        boardId: '<string>',
        link: '<string>',
        alt_text: '<string>'
      },
      reddit: {message: '<string>', subreddit: '<string>', subredditName: '<string>'},
      snapchat: {message: '<string>'}
    },
    webhook_url: '<string>'
  })
};

fetch('https://mallary.ai/api/v1/post', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://mallary.ai/api/v1/post",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'message' => '<string>',
    'platforms' => [
        
    ],
    'profile_id' => 'AbC123xYz90',
    'media' => [
        [
                'url' => '<string>',
                'type' => '<string>',
                'thumbnail_url' => '<string>'
        ]
    ],
    'comments_under_post' => [
        '<string>'
    ],
    'scheduled_at' => '<string>',
    'scheduled_timezone' => '<string>',
    'auto_reply_enabled' => true,
    'platform_options' => [
        'facebook' => [
                'message' => '<string>',
                'post_type' => 'feed'
        ],
        'instagram' => [
                'message' => '<string>',
                'post_type' => 'feed'
        ],
        'threads' => [
                'message' => '<string>'
        ],
        'twitter' => [
                'message' => '<string>'
        ],
        'x' => [
                'message' => '<string>'
        ],
        'linkedin' => [
                'message' => '<string>',
                'author_urn' => '<string>'
        ],
        'tiktok' => [
                'message' => '<string>',
                'media_type' => 'PHOTO',
                'post_mode' => 'MEDIA_UPLOAD',
                'title' => '<string>',
                'description' => '<string>',
                'disable_comment' => true,
                'disable_duet' => true,
                'disable_stitch' => true,
                'video_cover_timestamp_ms' => 1,
                'auto_add_music' => true,
                'brand_content_toggle' => true,
                'brand_organic_toggle' => true,
                'is_aigc' => true,
                'photo_cover_index' => 0
        ],
        'youtube' => [
                'message' => '<string>',
                'title' => '<string>',
                'visibility' => 'public',
                'categoryId' => '22',
                'madeForKids' => false
        ],
        'pinterest' => [
                'message' => '<string>',
                'title' => '<string>',
                'boardId' => '<string>',
                'link' => '<string>',
                'alt_text' => '<string>'
        ],
        'reddit' => [
                'message' => '<string>',
                'subreddit' => '<string>',
                'subredditName' => '<string>'
        ],
        'snapchat' => [
                'message' => '<string>'
        ]
    ],
    'webhook_url' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://mallary.ai/api/v1/post"

	payload := strings.NewReader("{\n  \"message\": \"<string>\",\n  \"platforms\": [],\n  \"profile_id\": \"AbC123xYz90\",\n  \"media\": [\n    {\n      \"url\": \"<string>\",\n      \"type\": \"<string>\",\n      \"thumbnail_url\": \"<string>\"\n    }\n  ],\n  \"comments_under_post\": [\n    \"<string>\"\n  ],\n  \"scheduled_at\": \"<string>\",\n  \"scheduled_timezone\": \"<string>\",\n  \"auto_reply_enabled\": true,\n  \"platform_options\": {\n    \"facebook\": {\n      \"message\": \"<string>\",\n      \"post_type\": \"feed\"\n    },\n    \"instagram\": {\n      \"message\": \"<string>\",\n      \"post_type\": \"feed\"\n    },\n    \"threads\": {\n      \"message\": \"<string>\"\n    },\n    \"twitter\": {\n      \"message\": \"<string>\"\n    },\n    \"x\": {\n      \"message\": \"<string>\"\n    },\n    \"linkedin\": {\n      \"message\": \"<string>\",\n      \"author_urn\": \"<string>\"\n    },\n    \"tiktok\": {\n      \"message\": \"<string>\",\n      \"media_type\": \"PHOTO\",\n      \"post_mode\": \"MEDIA_UPLOAD\",\n      \"title\": \"<string>\",\n      \"description\": \"<string>\",\n      \"disable_comment\": true,\n      \"disable_duet\": true,\n      \"disable_stitch\": true,\n      \"video_cover_timestamp_ms\": 1,\n      \"auto_add_music\": true,\n      \"brand_content_toggle\": true,\n      \"brand_organic_toggle\": true,\n      \"is_aigc\": true,\n      \"photo_cover_index\": 0\n    },\n    \"youtube\": {\n      \"message\": \"<string>\",\n      \"title\": \"<string>\",\n      \"visibility\": \"public\",\n      \"categoryId\": \"22\",\n      \"madeForKids\": false\n    },\n    \"pinterest\": {\n      \"message\": \"<string>\",\n      \"title\": \"<string>\",\n      \"boardId\": \"<string>\",\n      \"link\": \"<string>\",\n      \"alt_text\": \"<string>\"\n    },\n    \"reddit\": {\n      \"message\": \"<string>\",\n      \"subreddit\": \"<string>\",\n      \"subredditName\": \"<string>\"\n    },\n    \"snapchat\": {\n      \"message\": \"<string>\"\n    }\n  },\n  \"webhook_url\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://mallary.ai/api/v1/post")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"message\": \"<string>\",\n  \"platforms\": [],\n  \"profile_id\": \"AbC123xYz90\",\n  \"media\": [\n    {\n      \"url\": \"<string>\",\n      \"type\": \"<string>\",\n      \"thumbnail_url\": \"<string>\"\n    }\n  ],\n  \"comments_under_post\": [\n    \"<string>\"\n  ],\n  \"scheduled_at\": \"<string>\",\n  \"scheduled_timezone\": \"<string>\",\n  \"auto_reply_enabled\": true,\n  \"platform_options\": {\n    \"facebook\": {\n      \"message\": \"<string>\",\n      \"post_type\": \"feed\"\n    },\n    \"instagram\": {\n      \"message\": \"<string>\",\n      \"post_type\": \"feed\"\n    },\n    \"threads\": {\n      \"message\": \"<string>\"\n    },\n    \"twitter\": {\n      \"message\": \"<string>\"\n    },\n    \"x\": {\n      \"message\": \"<string>\"\n    },\n    \"linkedin\": {\n      \"message\": \"<string>\",\n      \"author_urn\": \"<string>\"\n    },\n    \"tiktok\": {\n      \"message\": \"<string>\",\n      \"media_type\": \"PHOTO\",\n      \"post_mode\": \"MEDIA_UPLOAD\",\n      \"title\": \"<string>\",\n      \"description\": \"<string>\",\n      \"disable_comment\": true,\n      \"disable_duet\": true,\n      \"disable_stitch\": true,\n      \"video_cover_timestamp_ms\": 1,\n      \"auto_add_music\": true,\n      \"brand_content_toggle\": true,\n      \"brand_organic_toggle\": true,\n      \"is_aigc\": true,\n      \"photo_cover_index\": 0\n    },\n    \"youtube\": {\n      \"message\": \"<string>\",\n      \"title\": \"<string>\",\n      \"visibility\": \"public\",\n      \"categoryId\": \"22\",\n      \"madeForKids\": false\n    },\n    \"pinterest\": {\n      \"message\": \"<string>\",\n      \"title\": \"<string>\",\n      \"boardId\": \"<string>\",\n      \"link\": \"<string>\",\n      \"alt_text\": \"<string>\"\n    },\n    \"reddit\": {\n      \"message\": \"<string>\",\n      \"subreddit\": \"<string>\",\n      \"subredditName\": \"<string>\"\n    },\n    \"snapchat\": {\n      \"message\": \"<string>\"\n    }\n  },\n  \"webhook_url\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://mallary.ai/api/v1/post")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"message\": \"<string>\",\n  \"platforms\": [],\n  \"profile_id\": \"AbC123xYz90\",\n  \"media\": [\n    {\n      \"url\": \"<string>\",\n      \"type\": \"<string>\",\n      \"thumbnail_url\": \"<string>\"\n    }\n  ],\n  \"comments_under_post\": [\n    \"<string>\"\n  ],\n  \"scheduled_at\": \"<string>\",\n  \"scheduled_timezone\": \"<string>\",\n  \"auto_reply_enabled\": true,\n  \"platform_options\": {\n    \"facebook\": {\n      \"message\": \"<string>\",\n      \"post_type\": \"feed\"\n    },\n    \"instagram\": {\n      \"message\": \"<string>\",\n      \"post_type\": \"feed\"\n    },\n    \"threads\": {\n      \"message\": \"<string>\"\n    },\n    \"twitter\": {\n      \"message\": \"<string>\"\n    },\n    \"x\": {\n      \"message\": \"<string>\"\n    },\n    \"linkedin\": {\n      \"message\": \"<string>\",\n      \"author_urn\": \"<string>\"\n    },\n    \"tiktok\": {\n      \"message\": \"<string>\",\n      \"media_type\": \"PHOTO\",\n      \"post_mode\": \"MEDIA_UPLOAD\",\n      \"title\": \"<string>\",\n      \"description\": \"<string>\",\n      \"disable_comment\": true,\n      \"disable_duet\": true,\n      \"disable_stitch\": true,\n      \"video_cover_timestamp_ms\": 1,\n      \"auto_add_music\": true,\n      \"brand_content_toggle\": true,\n      \"brand_organic_toggle\": true,\n      \"is_aigc\": true,\n      \"photo_cover_index\": 0\n    },\n    \"youtube\": {\n      \"message\": \"<string>\",\n      \"title\": \"<string>\",\n      \"visibility\": \"public\",\n      \"categoryId\": \"22\",\n      \"madeForKids\": false\n    },\n    \"pinterest\": {\n      \"message\": \"<string>\",\n      \"title\": \"<string>\",\n      \"boardId\": \"<string>\",\n      \"link\": \"<string>\",\n      \"alt_text\": \"<string>\"\n    },\n    \"reddit\": {\n      \"message\": \"<string>\",\n      \"subreddit\": \"<string>\",\n      \"subredditName\": \"<string>\"\n    },\n    \"snapchat\": {\n      \"message\": \"<string>\"\n    }\n  },\n  \"webhook_url\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "queued",
  "batch_id": "<string>",
  "profile_id": "<string>",
  "jobs": [
    {
      "jobId": "<string>",
      "platform_post_id": "<string>",
      "platform_post_url": "<string>"
    }
  ]
}

Connection Profiles

Use profile_id to publish from a non-default connection profile. Omit it to use the default profile. Connection profiles let one Mallary user connect multiple accounts on the same platform. Plan caps per platform are: Free 1, Starter 4, Pro 10, Business 50.

Scheduling

If you already know the exact UTC or offset time, use scheduled_at with an absolute timestamp like 2026-04-06T18:30:00Z.
To resolve the post in a specific timezone, use a local scheduled_at like 2026-04-06T14:30 plus scheduled_timezone with an IANA timezone like America/New_York.
Mallary stores the resolved publish time in UTC and returns the original scheduled_timezone on grouped post reads.

Publish Results

Post creation is asynchronous. The create response returns one Mallary job ID per platform immediately, with platform_post_id and platform_post_url set to null until that platform finishes publishing. After completion, use GET /api/v1/jobs/{id} or GET /api/v1/posts. These return the platform post ID and the public post URL that the platform exposes.

Video Thumbnails

Attach a custom thumbnail or cover to a video media item with thumbnail_url.

{
  "message": "Launch walkthrough",
  "platforms": ["youtube", "facebook", "instagram", "tiktok"],
  "media": [
    {
      "url": "https://files.mallary.ai/uploads/launch-video.mp4",
      "type": "video/mp4",
      "thumbnail_url": "https://files.mallary.ai/uploads/launch-cover.jpg"
    }
  ]
}

thumbnail_url must be a Mallary-hosted image URL, usually created with POST /api/v1/upload. Mallary skips a thumbnail that is unsupported for the platform, wrong for the post type, or rejected by the provider. It then continues to publish the post where possible. Current thumbnail behavior:

YouTube regular videos: supported. Mallary accepts jpg, jpeg, or png thumbnail images up to 2 MB. When the dimensions are known, Mallary requires at least 640px width. Mallary skips images that are not close to 16:9. Recommended: 1280x720 16:9. Mallary skips YouTube Shorts thumbnails.
Facebook videos: supported for video uploads. Mallary accepts jpg, jpeg, or png thumbnail images up to 10 MB and retries without the thumbnail if Meta rejects it.
Instagram videos/Reels: supported with a Mallary-hosted cover_url. Use a cover image that matches the video placement, such as 9:16 for Reels/stories. If Meta rejects a cover variant, Mallary falls back to video creation without the cover.
TikTok video posts: TikTok currently exposes frame-based cover selection through video_cover_timestamp_ms, not arbitrary image thumbnails. If thumbnail_url is supplied, Mallary does not send video_cover_timestamp_ms and lets TikTok use its default cover behavior.
TikTok photo posts: thumbnail_url can choose the photo cover only when it exactly matches one of the image URLs in media[]. Mallary then uses that image index as photo_cover_index. Mallary does not upload it as an extra photo.

Platform-Specific Media Rules

Mallary validates media before it queues a platform job. The public API and the current publishers enforce these media rules. For a simple guide to each setting, see Platform Posting Options.

Facebook

Feed posts can be text-only, link-only, up to 10 images, or 1 video.
Facebook does not allow mixing images and video in the same post.
Feed images accept jpg, jpeg, png, gif, and webp. Feed video accepts mp4 and mov.
Facebook stories support 1 image or 1 video.
platform_options.facebook.message sets a Facebook-specific message. Omit it to use the top-level message.

Instagram

Instagram requires media.
The validator currently defines: feed = 1 image or 1 video, story = 1 image or 1 video, reel = 1 video, carousel = 2 to 10 mixed image/video items.
The publisher uses the matching Instagram container flow for feed, story, reel, and carousel when selected through platform_options.instagram.post_type.
platform_options.instagram.message sets an Instagram-specific caption. Omit it to use the top-level message.
Instagram’s publishing API does not support story captions or follow-up comments. Include story text in the media itself.
Instagram image uploads use jpg, jpeg, or png. Video uploads use mp4 or mov.

LinkedIn supports text-only posts or one image attachment.
Mallary rejects LinkedIn video attachments before queueing.
LinkedIn image attachments accept jpg, jpeg, png, or gif.
platform_options.linkedin.message sets a LinkedIn-specific message. Omit it to use the top-level message.

Threads

Threads supports four posting shapes: text, image, video, and carousel.
Text posts are text-only and cannot include media.
Image posts support exactly 1 image in jpg, jpeg, png, or webp.
Video posts support exactly 1 video in mp4 or mov.
Carousel posts support 2 to 20 supported media items total.
platform_options.threads.post_type can be text, image, video, or carousel.
If you omit platform_options.threads.post_type, Mallary chooses from the payload: no media = text, one image = image, one video = video, multiple supported media items = carousel.
platform_options.threads.message sets a Threads-specific message. Omit it to use the top-level message.
Threads currently supports comments_under_post.

YouTube

YouTube requires exactly one video.
regular video supports one video up to 12 hours and up to 256 GB.
shorts supports one video up to 3 minutes. Use vertical video.
YouTube posting does not support images.
platform_options.youtube.message sets a YouTube-specific description/default-title source. Omit it to use the top-level message.
platform_options.youtube.title sets the YouTube title and takes precedence over the first line of the effective message.

TikTok

TikTok video posts support one video file in mp4, mov, or webm.
TikTok photo posts support up to 35 images in jpg, jpeg, or webp.
platform_options.tiktok.post_type can be video or photo.
platform_options.tiktok.post_mode can be DIRECT_POST or MEDIA_UPLOAD.
TikTok defaults to MEDIA_UPLOAD, which sends the upload to the creator inbox for final review and publishing inside TikTok.
Use DIRECT_POST only when you want Mallary to publish directly to TikTok without that inbox review step.
For TikTok video posts, platform_options.tiktok.source can be FILE_UPLOAD or PULL_FROM_URL.
For TikTok photo posts, TikTok only allows PULL_FROM_URL.
For TikTok PULL_FROM_URL, Mallary only accepts media already hosted on the Mallary CDN (https://files.mallary.ai/...).
platform_options.tiktok.message sets a TikTok-specific caption/title fallback. Omit it to use the top-level message.
platform_options.tiktok.title sets the TikTok title and takes precedence over the effective message where TikTok accepts a title.
platform_options.tiktok.description sets the TikTok photo description.
Direct-post TikTok options include privacy_level, disable_comment, disable_duet, disable_stitch, video_cover_timestamp_ms, auto_add_music, brand_content_toggle, brand_organic_toggle, is_aigc, and photo_cover_index where applicable.
TikTok posts do not currently support comments_under_post.

Pinterest requires exactly one image or GIF, or exactly one video.
Pinterest does not allow mixing image and video in the same Pin.
Image Pins accept one jpg, jpeg, png, webp, or gif file up to 32 MB.
Video Pins accept one mp4 or mov file, 4 seconds to 15 minutes, up to 2 GB.
A Pinterest board is required. Send boardId, or use the board saved with the Pinterest connection.
platform_options.pinterest.message sets a Pinterest-specific description/default title source. Omit it to use the top-level message.

text and link posts do not upload media through the Mallary API.
image posts require one image or GIF up to 20 MB.
The current public API path does not support Reddit video upload. To point at externally hosted video, use a link post.
subreddit or subredditName is required in platform options.
platform_options.reddit.message sets a Reddit-specific title/text source. Omit it to use the top-level message.

Snapchat

Snapchat posting requires Snapchat Public Profile or Marketing API access plus Mallary server credentials before any post can succeed.
The validation target is: story or saved_story = one image or one mp4 video, spotlight = one mp4 video.
Snapchat supports only one media item per post.
Snapchat video must be 5 to 60 seconds.
The current publisher implementation fails fast until you enable Snapchat partner access and credentials.
platform_options.snapchat.message sets a Snapchat-specific message. Omit it to use the top-level message.

X

X allows up to 4 images, or 1 video, or 1 GIF.
X does not allow mixing images and video in the same post.
GIFs cannot be combined with other attachments.
X images accept jpg, jpeg, png, webp, and gif. Video accepts mp4 or mov.
X video supports up to 140 seconds and up to 512 MB.
platform_options.x.message or platform_options.twitter.message sets an X-specific message. Omit it to use the top-level message.

Authorizations

Authorization

string

header

required

Use Authorization: Bearer {api_key}

Headers

Idempotency-Key

string

Optional idempotency key to prevent duplicate submissions.

Body

application/json

message

string

required

Minimum string length: 1

platforms

enum<string>[]

required

Minimum array length: 1

Supported publishing platform identifier.

Available options:

twitter,

x,

facebook,

instagram,

linkedin,

youtube,

tiktok,

pinterest,

reddit,

threads,

snapchat

profile_id

string

Connection profile to publish from. Omit to use the default profile.

Pattern: ^[A-Za-z0-9]{6,32}$

Example:

"AbC123xYz90"

media

object[]

Media URLs obtained from using the /api/v1/upload endpoint.

Show child attributes

comments_under_post

string[]

Up to 3 follow-up comments/replies under the main post when supported by the target platform/format.

Maximum array length: 3

scheduled_at

string

Optional scheduled publish timestamp. Send an absolute timestamp like 2026-04-06T18:30:00Z, or send a local datetime like 2026-04-06T14:30 together with scheduled_timezone.

scheduled_timezone

string

Optional IANA timezone such as America/New_York. When provided with a local scheduled_at that omits an offset, Mallary resolves the wall-clock time in this timezone and stores the resulting UTC publish time.

auto_reply_enabled

boolean

Optional per-post override for AI auto-replies.

platform_options

object

Optional per-platform overrides.

Show child attributes

webhook_url

string<uri>

Optional callback URL for completion notifications.

Response

Jobs enqueued

status

enum<string>

Available options:

queued

batch_id

string

profile_id

string | null

Pattern: ^[A-Za-z0-9]{6,32}$

jobs

object[]

Show child attributes

Last modified on August 11, 2026

Create or schedule a post across platforms

curl --request POST \
  --url https://mallary.ai/api/v1/post \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": "<string>",
  "platforms": [],
  "profile_id": "AbC123xYz90",
  "media": [
    {
      "url": "<string>",
      "type": "<string>",
      "thumbnail_url": "<string>"
    }
  ],
  "comments_under_post": [
    "<string>"
  ],
  "scheduled_at": "<string>",
  "scheduled_timezone": "<string>",
  "auto_reply_enabled": true,
  "platform_options": {
    "facebook": {
      "message": "<string>",
      "post_type": "feed"
    },
    "instagram": {
      "message": "<string>",
      "post_type": "feed"
    },
    "threads": {
      "message": "<string>"
    },
    "twitter": {
      "message": "<string>"
    },
    "x": {
      "message": "<string>"
    },
    "linkedin": {
      "message": "<string>",
      "author_urn": "<string>"
    },
    "tiktok": {
      "message": "<string>",
      "media_type": "PHOTO",
      "post_mode": "MEDIA_UPLOAD",
      "title": "<string>",
      "description": "<string>",
      "disable_comment": true,
      "disable_duet": true,
      "disable_stitch": true,
      "video_cover_timestamp_ms": 1,
      "auto_add_music": true,
      "brand_content_toggle": true,
      "brand_organic_toggle": true,
      "is_aigc": true,
      "photo_cover_index": 0
    },
    "youtube": {
      "message": "<string>",
      "title": "<string>",
      "visibility": "public",
      "categoryId": "22",
      "madeForKids": false
    },
    "pinterest": {
      "message": "<string>",
      "title": "<string>",
      "boardId": "<string>",
      "link": "<string>",
      "alt_text": "<string>"
    },
    "reddit": {
      "message": "<string>",
      "subreddit": "<string>",
      "subredditName": "<string>"
    },
    "snapchat": {
      "message": "<string>"
    }
  },
  "webhook_url": "<string>"
}
'

import requests

url = "https://mallary.ai/api/v1/post"

payload = {
    "message": "<string>",
    "platforms": [],
    "profile_id": "AbC123xYz90",
    "media": [
        {
            "url": "<string>",
            "type": "<string>",
            "thumbnail_url": "<string>"
        }
    ],
    "comments_under_post": ["<string>"],
    "scheduled_at": "<string>",
    "scheduled_timezone": "<string>",
    "auto_reply_enabled": True,
    "platform_options": {
        "facebook": {
            "message": "<string>",
            "post_type": "feed"
        },
        "instagram": {
            "message": "<string>",
            "post_type": "feed"
        },
        "threads": { "message": "<string>" },
        "twitter": { "message": "<string>" },
        "x": { "message": "<string>" },
        "linkedin": {
            "message": "<string>",
            "author_urn": "<string>"
        },
        "tiktok": {
            "message": "<string>",
            "media_type": "PHOTO",
            "post_mode": "MEDIA_UPLOAD",
            "title": "<string>",
            "description": "<string>",
            "disable_comment": True,
            "disable_duet": True,
            "disable_stitch": True,
            "video_cover_timestamp_ms": 1,
            "auto_add_music": True,
            "brand_content_toggle": True,
            "brand_organic_toggle": True,
            "is_aigc": True,
            "photo_cover_index": 0
        },
        "youtube": {
            "message": "<string>",
            "title": "<string>",
            "visibility": "public",
            "categoryId": "22",
            "madeForKids": False
        },
        "pinterest": {
            "message": "<string>",
            "title": "<string>",
            "boardId": "<string>",
            "link": "<string>",
            "alt_text": "<string>"
        },
        "reddit": {
            "message": "<string>",
            "subreddit": "<string>",
            "subredditName": "<string>"
        },
        "snapchat": { "message": "<string>" }
    },
    "webhook_url": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    message: '<string>',
    platforms: [],
    profile_id: 'AbC123xYz90',
    media: [{url: '<string>', type: '<string>', thumbnail_url: '<string>'}],
    comments_under_post: ['<string>'],
    scheduled_at: '<string>',
    scheduled_timezone: '<string>',
    auto_reply_enabled: true,
    platform_options: {
      facebook: {message: '<string>', post_type: 'feed'},
      instagram: {message: '<string>', post_type: 'feed'},
      threads: {message: '<string>'},
      twitter: {message: '<string>'},
      x: {message: '<string>'},
      linkedin: {message: '<string>', author_urn: '<string>'},
      tiktok: {
        message: '<string>',
        media_type: 'PHOTO',
        post_mode: 'MEDIA_UPLOAD',
        title: '<string>',
        description: '<string>',
        disable_comment: true,
        disable_duet: true,
        disable_stitch: true,
        video_cover_timestamp_ms: 1,
        auto_add_music: true,
        brand_content_toggle: true,
        brand_organic_toggle: true,
        is_aigc: true,
        photo_cover_index: 0
      },
      youtube: {
        message: '<string>',
        title: '<string>',
        visibility: 'public',
        categoryId: '22',
        madeForKids: false
      },
      pinterest: {
        message: '<string>',
        title: '<string>',
        boardId: '<string>',
        link: '<string>',
        alt_text: '<string>'
      },
      reddit: {message: '<string>', subreddit: '<string>', subredditName: '<string>'},
      snapchat: {message: '<string>'}
    },
    webhook_url: '<string>'
  })
};

fetch('https://mallary.ai/api/v1/post', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://mallary.ai/api/v1/post",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'message' => '<string>',
    'platforms' => [
        
    ],
    'profile_id' => 'AbC123xYz90',
    'media' => [
        [
                'url' => '<string>',
                'type' => '<string>',
                'thumbnail_url' => '<string>'
        ]
    ],
    'comments_under_post' => [
        '<string>'
    ],
    'scheduled_at' => '<string>',
    'scheduled_timezone' => '<string>',
    'auto_reply_enabled' => true,
    'platform_options' => [
        'facebook' => [
                'message' => '<string>',
                'post_type' => 'feed'
        ],
        'instagram' => [
                'message' => '<string>',
                'post_type' => 'feed'
        ],
        'threads' => [
                'message' => '<string>'
        ],
        'twitter' => [
                'message' => '<string>'
        ],
        'x' => [
                'message' => '<string>'
        ],
        'linkedin' => [
                'message' => '<string>',
                'author_urn' => '<string>'
        ],
        'tiktok' => [
                'message' => '<string>',
                'media_type' => 'PHOTO',
                'post_mode' => 'MEDIA_UPLOAD',
                'title' => '<string>',
                'description' => '<string>',
                'disable_comment' => true,
                'disable_duet' => true,
                'disable_stitch' => true,
                'video_cover_timestamp_ms' => 1,
                'auto_add_music' => true,
                'brand_content_toggle' => true,
                'brand_organic_toggle' => true,
                'is_aigc' => true,
                'photo_cover_index' => 0
        ],
        'youtube' => [
                'message' => '<string>',
                'title' => '<string>',
                'visibility' => 'public',
                'categoryId' => '22',
                'madeForKids' => false
        ],
        'pinterest' => [
                'message' => '<string>',
                'title' => '<string>',
                'boardId' => '<string>',
                'link' => '<string>',
                'alt_text' => '<string>'
        ],
        'reddit' => [
                'message' => '<string>',
                'subreddit' => '<string>',
                'subredditName' => '<string>'
        ],
        'snapchat' => [
                'message' => '<string>'
        ]
    ],
    'webhook_url' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://mallary.ai/api/v1/post"

	payload := strings.NewReader("{\n  \"message\": \"<string>\",\n  \"platforms\": [],\n  \"profile_id\": \"AbC123xYz90\",\n  \"media\": [\n    {\n      \"url\": \"<string>\",\n      \"type\": \"<string>\",\n      \"thumbnail_url\": \"<string>\"\n    }\n  ],\n  \"comments_under_post\": [\n    \"<string>\"\n  ],\n  \"scheduled_at\": \"<string>\",\n  \"scheduled_timezone\": \"<string>\",\n  \"auto_reply_enabled\": true,\n  \"platform_options\": {\n    \"facebook\": {\n      \"message\": \"<string>\",\n      \"post_type\": \"feed\"\n    },\n    \"instagram\": {\n      \"message\": \"<string>\",\n      \"post_type\": \"feed\"\n    },\n    \"threads\": {\n      \"message\": \"<string>\"\n    },\n    \"twitter\": {\n      \"message\": \"<string>\"\n    },\n    \"x\": {\n      \"message\": \"<string>\"\n    },\n    \"linkedin\": {\n      \"message\": \"<string>\",\n      \"author_urn\": \"<string>\"\n    },\n    \"tiktok\": {\n      \"message\": \"<string>\",\n      \"media_type\": \"PHOTO\",\n      \"post_mode\": \"MEDIA_UPLOAD\",\n      \"title\": \"<string>\",\n      \"description\": \"<string>\",\n      \"disable_comment\": true,\n      \"disable_duet\": true,\n      \"disable_stitch\": true,\n      \"video_cover_timestamp_ms\": 1,\n      \"auto_add_music\": true,\n      \"brand_content_toggle\": true,\n      \"brand_organic_toggle\": true,\n      \"is_aigc\": true,\n      \"photo_cover_index\": 0\n    },\n    \"youtube\": {\n      \"message\": \"<string>\",\n      \"title\": \"<string>\",\n      \"visibility\": \"public\",\n      \"categoryId\": \"22\",\n      \"madeForKids\": false\n    },\n    \"pinterest\": {\n      \"message\": \"<string>\",\n      \"title\": \"<string>\",\n      \"boardId\": \"<string>\",\n      \"link\": \"<string>\",\n      \"alt_text\": \"<string>\"\n    },\n    \"reddit\": {\n      \"message\": \"<string>\",\n      \"subreddit\": \"<string>\",\n      \"subredditName\": \"<string>\"\n    },\n    \"snapchat\": {\n      \"message\": \"<string>\"\n    }\n  },\n  \"webhook_url\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://mallary.ai/api/v1/post")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"message\": \"<string>\",\n  \"platforms\": [],\n  \"profile_id\": \"AbC123xYz90\",\n  \"media\": [\n    {\n      \"url\": \"<string>\",\n      \"type\": \"<string>\",\n      \"thumbnail_url\": \"<string>\"\n    }\n  ],\n  \"comments_under_post\": [\n    \"<string>\"\n  ],\n  \"scheduled_at\": \"<string>\",\n  \"scheduled_timezone\": \"<string>\",\n  \"auto_reply_enabled\": true,\n  \"platform_options\": {\n    \"facebook\": {\n      \"message\": \"<string>\",\n      \"post_type\": \"feed\"\n    },\n    \"instagram\": {\n      \"message\": \"<string>\",\n      \"post_type\": \"feed\"\n    },\n    \"threads\": {\n      \"message\": \"<string>\"\n    },\n    \"twitter\": {\n      \"message\": \"<string>\"\n    },\n    \"x\": {\n      \"message\": \"<string>\"\n    },\n    \"linkedin\": {\n      \"message\": \"<string>\",\n      \"author_urn\": \"<string>\"\n    },\n    \"tiktok\": {\n      \"message\": \"<string>\",\n      \"media_type\": \"PHOTO\",\n      \"post_mode\": \"MEDIA_UPLOAD\",\n      \"title\": \"<string>\",\n      \"description\": \"<string>\",\n      \"disable_comment\": true,\n      \"disable_duet\": true,\n      \"disable_stitch\": true,\n      \"video_cover_timestamp_ms\": 1,\n      \"auto_add_music\": true,\n      \"brand_content_toggle\": true,\n      \"brand_organic_toggle\": true,\n      \"is_aigc\": true,\n      \"photo_cover_index\": 0\n    },\n    \"youtube\": {\n      \"message\": \"<string>\",\n      \"title\": \"<string>\",\n      \"visibility\": \"public\",\n      \"categoryId\": \"22\",\n      \"madeForKids\": false\n    },\n    \"pinterest\": {\n      \"message\": \"<string>\",\n      \"title\": \"<string>\",\n      \"boardId\": \"<string>\",\n      \"link\": \"<string>\",\n      \"alt_text\": \"<string>\"\n    },\n    \"reddit\": {\n      \"message\": \"<string>\",\n      \"subreddit\": \"<string>\",\n      \"subredditName\": \"<string>\"\n    },\n    \"snapchat\": {\n      \"message\": \"<string>\"\n    }\n  },\n  \"webhook_url\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://mallary.ai/api/v1/post")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"message\": \"<string>\",\n  \"platforms\": [],\n  \"profile_id\": \"AbC123xYz90\",\n  \"media\": [\n    {\n      \"url\": \"<string>\",\n      \"type\": \"<string>\",\n      \"thumbnail_url\": \"<string>\"\n    }\n  ],\n  \"comments_under_post\": [\n    \"<string>\"\n  ],\n  \"scheduled_at\": \"<string>\",\n  \"scheduled_timezone\": \"<string>\",\n  \"auto_reply_enabled\": true,\n  \"platform_options\": {\n    \"facebook\": {\n      \"message\": \"<string>\",\n      \"post_type\": \"feed\"\n    },\n    \"instagram\": {\n      \"message\": \"<string>\",\n      \"post_type\": \"feed\"\n    },\n    \"threads\": {\n      \"message\": \"<string>\"\n    },\n    \"twitter\": {\n      \"message\": \"<string>\"\n    },\n    \"x\": {\n      \"message\": \"<string>\"\n    },\n    \"linkedin\": {\n      \"message\": \"<string>\",\n      \"author_urn\": \"<string>\"\n    },\n    \"tiktok\": {\n      \"message\": \"<string>\",\n      \"media_type\": \"PHOTO\",\n      \"post_mode\": \"MEDIA_UPLOAD\",\n      \"title\": \"<string>\",\n      \"description\": \"<string>\",\n      \"disable_comment\": true,\n      \"disable_duet\": true,\n      \"disable_stitch\": true,\n      \"video_cover_timestamp_ms\": 1,\n      \"auto_add_music\": true,\n      \"brand_content_toggle\": true,\n      \"brand_organic_toggle\": true,\n      \"is_aigc\": true,\n      \"photo_cover_index\": 0\n    },\n    \"youtube\": {\n      \"message\": \"<string>\",\n      \"title\": \"<string>\",\n      \"visibility\": \"public\",\n      \"categoryId\": \"22\",\n      \"madeForKids\": false\n    },\n    \"pinterest\": {\n      \"message\": \"<string>\",\n      \"title\": \"<string>\",\n      \"boardId\": \"<string>\",\n      \"link\": \"<string>\",\n      \"alt_text\": \"<string>\"\n    },\n    \"reddit\": {\n      \"message\": \"<string>\",\n      \"subreddit\": \"<string>\",\n      \"subredditName\": \"<string>\"\n    },\n    \"snapchat\": {\n      \"message\": \"<string>\"\n    }\n  },\n  \"webhook_url\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "queued",
  "batch_id": "<string>",
  "profile_id": "<string>",
  "jobs": [
    {
      "jobId": "<string>",
      "platform_post_id": "<string>",
      "platform_post_url": "<string>"
    }
  ]
}

Overview

Endpoints

Connection Profiles

Scheduling

Publish Results

Video Thumbnails

Platform-Specific Media Rules

Facebook

Instagram

LinkedIn

Threads

YouTube

TikTok

Pinterest

Reddit

Snapchat

X

Authorizations

Headers

Body

Response

​Connection Profiles

​Scheduling

​Publish Results

​Video Thumbnails

​Platform-Specific Media Rules

​Facebook

​Instagram

​LinkedIn

​Threads

​YouTube

​TikTok

​Pinterest

​Reddit

​Snapchat

​X

Authorizations

Headers

Body

Response

Connection Profiles

Scheduling

Publish Results

Video Thumbnails

Platform-Specific Media Rules

Facebook

Instagram

LinkedIn

Threads

YouTube

TikTok

Pinterest

Reddit

Snapchat

X