Skip to main content
POST
/
social
/
post
Create Social Post
curl --request POST \
  --url https://api.example.com/social/post
Publishes immediately or schedules a social post and returns a post ID.

​
Request

curl -X POST "https://api.mosaic.so/social/post" \
  -H "Authorization: Bearer mk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "post": "New product update 🚀",
    "platforms": ["x", "linkedin"],
    "media_urls": ["https://cdn.yourdomain.com/media/launch.mp4"],
    "schedule_date": "2026-03-10T16:00:00Z"
  }'

​
Body Parameters

FieldTypeRequiredDescription
poststringNoPost text (defaults to empty string).
platformsarrayYesOne or more target platforms (x, linkedin, instagram, facebook, tiktok, youtube).
media_urlsarrayNoPublic media URLs to attach.
schedule_datestringNoISO timestamp to schedule instead of posting immediately.
Additional provider-specific fields are forwarded to Ayrshare.

​
Response

{
  "post_id": "1c08fd57-f0b0-4d10-bf7a-1df2e03c1a96",
  "status": "success",
  "links": [
    {
      "platform": "x",
      "post_url": "https://x.com/usemosaic_ai/status/123"
    }
  ]
}

​
Ayrshare References