Create draft post

POST

/v1/posts

Creates a draft post for a provider. providerId — use POST /api/integrations/filter-integrations to obtain integration id values. Optional media entries reference fileName values from /media/upload or /media/upload-url.

Cross-post repost (manual): set isRepost: true and repostContext.parent to another post id when modeling a simple repost relationship (distinct from automation cross-account repost configured via /posts/{postId}/reposting).

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Created post (serialized post resource)

Bodyapplication/json

🟠400

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://app.highperformr.ai/api/v1/posts' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "content": "Hello from the API",
    "providerId": "mQQqMeclDHmvr40TbhIU",
    "media": [
        {
            "contentType": "image/jpeg",
            "fileName": "images/user-uploads/acc/uuid.jpg",
            "title": "Hero"
        }
    ]
}'

Response Example

200 - Example 1

{
    "property1": "string",
    "property2": "string"
}

Modified at 2026-04-22 07:54:17

Get job status by id

List posts (drafts, scheduled, published)