Create and publish a post

POST

https://api.mediashare.com/api/posts

Create a post to one or more platforms. Supports:

contentType: "post" - Regular feed post (default)

contentType: "story" - 24-hour ephemeral story

contentType: "reel" - Short-form vertical video

Can schedule posts or publish immediately.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Post created successfully

Body

🟠400

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.mediashare.com/api/posts' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "platforms": [
        "instagram",
        "facebook"
    ],
    "text": "Check out this photo!",
    "hashtags": [
        "photography"
    ],
    "mediaUrls": [
        "https://example.com/photo.jpg"
    ]
}'

Response Example

201 - Example 1

{
    "message": "string",
    "post": {
        "_id": "string",
        "userId": "string",
        "platforms": [
            "facebook"
        ],
        "contentType": "post",
        "content": {
            "text": "string",
            "media": [
                {
                    "type": "image",
                    "url": "string",
                    "localPath": "string",
                    "mimeType": "string",
                    "size": 0
                }
            ],
            "hashtags": [
                "string"
            ],
            "mentions": [
                "string"
            ]
        },
        "status": "draft",
        "scheduledFor": "2019-08-24T14:15:22.123Z",
        "platformPosts": [
            {
                "platform": "string",
                "accountId": "string",
                "status": "pending",
                "platformPostId": "string",
                "platformUrl": "string",
                "publishedAt": "2019-08-24T14:15:22.123Z",
                "error": "string"
            }
        ],
        "createdAt": "2019-08-24T14:15:22.123Z"
    }
}

Modified at 2025-12-29 09:11:21

Connect a specific Facebook Page by ID

Get user's posts