social.createSchedule

post/v1/social/schedules

social.createSchedule

Request

Body

{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "content": {
            "type": "string",
            "maxLength": 5000
          },
          "scheduled_at": {
            "type": "string",
            "format": "date-time"
          },
          "options": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "platforms": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "facebook",
                "instagram",
                "twitter",
                "linkedin",
                "tiktok",
                "youtube",
                "pinterest",
                "threads",
                "bluesky",
                "telegram",
                "google_business",
                "reddit",
                "snapchat"
              ]
            },
            "minItems": 1
          },
          "media": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "image",
                    "video"
                  ]
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                }
              },
              "required": [
                "type",
                "url"
              ]
            }
          }
        },
        "required": [
          "content",
          "scheduled_at",
          "platforms"
        ]
      }
    }
  }
}

Responses

201No description

Schema

Schema Structure

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "status": {
          "type": "string"
        },
        "scheduled_for": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "platforms": {
          "type": "array",
          "items": {}
        },
        "credits_used": {
          "type": "integer"
        }
      },
      "required": [
        "id",
        "status",
        "scheduled_for",
        "platforms",
        "credits_used"
      ]
    }
  },
  "required": [
    "success",
    "data"
  ]
}

402No description

Schema

Schema Structure

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "enum": [
            "INSUFFICIENT_CREDITS"
          ]
        },
        "message": {
          "type": "string",
          "enum": [
            "Not enough credits"
          ]
        }
      },
      "required": [
        "code",
        "message"
      ]
    }
  },
  "required": [
    "success",
    "error"
  ]
}

422Validation error

Schema

Schema Structure

{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Errors overview."
    },
    "errors": {
      "type": "object",
      "description": "A detailed description of each field that failed validation.",
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    }
  },
  "required": [
    "message",
    "errors"
  ]
}