Robopost REST API Reference

This document provides a reference for using the Robopost Public API directly via HTTP, rather than through the Python client library. Here, you’ll find endpoint details, request and response structures, authentication parameters, and usage examples in a REST context.

Base URL: https://public-api.robopost.app/v1

If you want to use the API through our Python Wrapper, click here.

Authentication

All requests to the Robopost Public API must include your API key as a query parameter:

?apikey=YOUR_API_KEY

For example:

POST /v1/scheduled_posts?apikey=YOUR_API_KEY

If the apikey is missing or invalid, the server will respond with an appropriate 4xx error status.

All endpoints discussed here require an API key, passed as a query parameter named apikey. You can generate API Keys under "Team" > "Manage API Keys".

Upload Media

Use this endpoint to upload images or videos that you want to attach to your scheduled posts. Each upload returns a media object containing the ID and a storage_object_id, which you’ll reference later when creating a scheduled post.

POST /medias/upload

• Authentication: apikey query parameter
• Request: multipart/form-data with a single field named file (the binary file to upload).
• Response: A JSON object describing the uploaded media.

Example Request (cURL)

curl -X POST \
  "https://public-api.robopost.app/v1/medias/upload?apikey=YOUR_API_KEY" \
  -F "file=@path/to/image.jpg"

Example Successful Response (JSON)

{
  "id": "64f20e2c915d2f1970ec8c09",
  "name": "image.jpg",
  "extension": "jpg",
  "storage_object_id": "9f73ad62-xxxxx-xxxxx-xxxxx-9556dcb903f4"
}

Create Scheduled Posts

Use this endpoint to schedule new posts (including drafts and recurring posts) across one or multiple social channels. You will need:

• The channel_id (or multiple IDs) for each social account.
• (Optionally) the storage_object_id for media uploads (if you plan to attach images or video).

POST /scheduled_posts/

• Authentication: apikey query parameter
• Request Body: JSON object matching the PublicAPIScheduledPostCreateHTTPPayload schema (see below).
• Response: Array of objects matching the PublicAPIScheduledPostRead schema, each representing a newly created scheduled post.

Note: The endpoint always returns an array (even if you only schedule one post).

URL

POST /v1/scheduled_posts/?apikey=YOUR_API_KEY

Example Request (cURL)

Below is an example showing how to schedule one post (with text, channel IDs, and an attached image).

curl -X POST \
  "https://public-api.robopost.app/v1/scheduled_posts/?apikey=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello from the REST API!",
    "channel_ids": ["my_facebook_channel_id"],
    "image_object_ids": ["9f73ad62-xxxxx-xxxxx-xxxxx-9556dcb903f4"],
    "schedule_at": "2025-03-01T10:00:00Z",
    "is_draft": false
  }'

Example Successful Response

[
  {
    "id": "64f20e2c915d2f1970ec8c09",
    "text": "Hello from the REST API!",
    "channel_ids": ["my_facebook_channel_id"],
    "image_object_ids": ["9f73ad62-xxxxx-xxxxx-xxxxx-9556dcb903f4"],
    "video_object_id": null,
    "gif_object_id": null,
    "facebook_settings": {
      "postType": "POST"
    },
    "instagram_settings": {
      "postType": "POST"
    },
    "pinterest_settings": {
      "pinTitle": "",
      "destinationLink": ""
    },
    "wordpress_settings": {
      "postTitle": "",
      "postText": "",
      "postSlug": "",
      "postType": "POST",
      "postCategories": [],
      "postTags": [],
      "postFeaturedImage": null,
      "postParentPage": 0
    },
    "youtube_settings": {
      "videoTitle": "",
      "videoType": "video",
      "videoDescription": "",
      "videoPrivacyStatus": "public",
      "videoThumbnailImageObject": null,
      "videoThumbnailGroupUuid": null
    },
    "tiktok_settings": {
      "title": "",
      "privacyLevel": "PUBLIC_TO_EVERYONE",
      "disableDuet": false,
      "disableComment": false,
      "disableStitch": false,
      "videoCoverTimestampMs": 0,
      "videoThumbnailGroupUuid": null,
      "autoAddMusic": true
    },
    "gmb_settings": {
      "postTopicType": "STANDARD",
      "offerTitle": "",
      "offerCouponCode": "",
      "offerRedeemOnlineUrl": "",
      "offerTermsConditions": "",
      "offerStartDt": null,
      "offerEndDt": null,
      "eventTitle": "",
      "eventStartDt": null,
      "eventEndDt": null,
      "ctaButtonActionType": "ACTION_TYPE_UNSPECIFIED",
      "ctaUrl": ""
    },
    "is_draft": false,
    "post_collection_id": null,
    "schedule_at": "2025-03-01T10:00:00Z",
    "is_recur": false,
    "recur_interval": "DAILY",
    "recur_generate_new_ai_image": false,
    "recur_generate_new_ai_image_model": "DALLE",
    "recur_until_dt": null,
    "recur_until_dt_enabled": false,
    "recur_rephrase_text_with_ai": false,
    "recur_rephrase_text_with_ai_tone": "FRIENDLY",
    "recur_interval_time_slots": []
  }
]

Request and Response Models

Below are the essential models for scheduling a post via the Robopost Public API.
These closely match the Python Pydantic models, but here we’ll describe them in a pure REST context.

PublicAPIScheduledPostCreateHTTPPayload

PublicAPIScheduledPostRead

Represents the newly created scheduled post (or draft) returned by the API. Most fields mirror those in the PublicAPIScheduledPostCreateHTTPPayload. Notable difference: the id is always set and additional fields reflect the final stored state.

FacebookSettings

InstagramSettings

PinterestSettings

WordpressSettings

YoutubeSettings

Note: The actual uploaded video is tied to video_object_id in the main payload. The videoType and videoPrivacyStatus further configure how YouTube handles it.

TikTokSettings

Note: The actual uploaded TikTok video is tied to video_object_id in the main payload.

GMBSettings

Enums

1. AIImageModel
   • DALLE, FLUX_SCHNELL, FLUX_DEV, FLUX_PRO
2. PostAIGenerateVoiceTone
   • Examples: POLITE, WITTY, INFORMATIONAL, FUNNY, FRIENDLY, etc.
3. AutomationRecurInterval
   • DAILY_SPECIFIC_TIME_SLOTS, WEEKLY_SPECIFIC_TIME_SLOTS, EVERY_3_HOURS, EVERY_6_HOURS, BI_DAILY, DAILY, WEEKLY, MONTHLY, YEARLY
4. FacebookPostType
   • POST, REELS
5. InstagramPostType
   • POST, REELS, STORIES
6. WordpressPostType
   • POST, PAGE (other types may be supported by your WP environment)
7. YoutubeVideoType
   • video, short
8. YoutubePrivacyStatus
   • public, private, unlisted
9. TikTokPrivacyLevel
   • PUBLIC_TO_EVERYONE
10. GMBPostTopicType
    • STANDARD, OFFER, EVENT
11. GMBCTAButtonActionType
    • ACTION_TYPE_UNSPECIFIED, BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP, CALL

Error Handling

The Robopost Public API responds with standard HTTP status codes to indicate success or failure:

Typical error responses include a JSON body describing the cause. For instance, if you try to schedule a post with no channel_ids (and is_draft=false), you’ll receive a 400 error.

Example Workflow

1. Upload Media (Optional)
   • POST /medias/upload?apikey=YOUR_API_KEY with multipart/form-data to get storage_object_id.
2. Create Scheduled Post
   • POST /scheduled_posts/?apikey=YOUR_API_KEY with a JSON body that includes:
     • channel_ids (unless you’re making a draft)
     • image_object_ids or video_object_id referencing any uploaded media
     • schedule_at in UTC
     • Any optional platform-specific settings (FacebookSettings, YouTubeSettings, etc.)
3. Receive Confirmation
   • The API returns an array of newly created post objects in JSON format.

Notes

• Dates/Times: Provide all datetimes in ISO 8601 format in UTC (e.g., "2025-03-02T15:30:00Z").
• Recurring Posts: If is_recur=true, you must specify recur_interval and any relevant fields for daily or weekly specific time slots (recur_interval_time_slots).
• Draft vs. Scheduled: Use is_draft=true for a draft (no immediate scheduling) or is_draft=false for an actual scheduled post.
• Post Collections: Provide post_collection_id if you want to group your posts; otherwise leave it as null or omit it.

For additional usage examples, please refer to the Python Client documentation or contact support.

Robopost – all-in-one AI-driven social media management!
For more information, visit: robopost.app