Create a new social post

post/v1/social/posts

Create a new social post

Request

Body

{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "content": {
            "type": "string",
            "maxLength": 5000
          },
          "scheduled_for": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "settings": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "platform_specific_content": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "link": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "first_comment": {
            "type": "boolean"
          },
          "first_comment_text": {
            "type": [
              "string",
              "null"
            ]
          },
          "webhook_url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "callback_url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "callback_secret": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 255
          },
          "platforms": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "facebook",
                "instagram",
                "twitter",
                "linkedin",
                "tiktok",
                "youtube",
                "pinterest",
                "threads",
                "bluesky",
                "telegram",
                "reddit",
                "snapchat",
                "google_business"
              ]
            },
            "minItems": 1
          },
          "media_urls": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "format": "uri"
            }
          }
        },
        "required": [
          "content",
          "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"
        },
        "credits_used": {
          "type": "string"
        },
        "created_at": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "status",
        "scheduled_for",
        "credits_used",
        "created_at"
      ]
    },
    "message": {
      "type": "string",
      "enum": [
        "Post is being published now",
        "Post scheduled successfully"
      ]
    }
  },
  "required": [
    "success",
    "data",
    "message"
  ]
}

400No description

Schema

Schema Structure

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "enum": [
            "MISSING_ACCOUNTS"
          ]
        },
        "message": {
          "type": "string"
        },
        "details": {
          "type": "object",
          "properties": {
            "missing_platforms": {
              "type": "array",
              "items": {}
            }
          },
          "required": [
            "missing_platforms"
          ]
        }
      },
      "required": [
        "code",
        "message",
        "details"
      ]
    }
  },
  "required": [
    "success",
    "error"
  ]
}

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"
          ]
        },
        "details": {
          "type": "object",
          "properties": {
            "required": {
              "type": "string"
            },
            "available": {
              "type": "number"
            }
          },
          "required": [
            "required",
            "available"
          ]
        }
      },
      "required": [
        "code",
        "message",
        "details"
      ]
    }
  },
  "required": [
    "success",
    "error"
  ]
}

422No description

Schema

Schema Structure

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "enum": [
            "VALIDATION_ERROR"
          ]
        },
        "message": {
          "type": "string",
          "enum": [
            "Validation failed"
          ]
        },
        "details": {
          "type": "object",
          "additionalProperties": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": "MessageBag"
        }
      },
      "required": [
        "code",
        "message",
        "details"
      ]
    }
  },
  "required": [
    "success",
    "error"
  ]
}