FeedHorizon API
Posts
POST
/posts

Create and optionally publish or schedule a post. Set publishNow: true for immediate publishing, scheduledFor for scheduling, or omit both for a draft.

Authorization

bearerAuth
AuthorizationBearer <token>

API key with fh_ prefix. Pass as Authorization: Bearer fh_...

In: header

Request Body

application/json

content?string

Post text content

platforms*array<>

Target platforms

profileId*string

Profile to post from

scheduledFor?string

Schedule for this time (ISO 8601)

Formatdate-time
timezone?string

Timezone for scheduling

Default"UTC"
publishNow?boolean

Publish immediately

Defaultfalse
mediaUrls?array<>

Media URLs to attach

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://app.feedhorizon.dev/api/v1/posts" \  -H "Content-Type: application/json" \  -d '{    "platforms": [      "linkedin"    ],    "profileId": "string"  }'
{
  "data": {
    "id": "string",
    "content": "string",
    "status": "DRAFT",
    "publishMode": "schedule",
    "scheduledAt": "2019-08-24T14:15:22Z",
    "timezone": "Europe/Berlin",
    "publishedAt": "2019-08-24T14:15:22Z",
    "platforms": [
      "linkedin"
    ],
    "platformPostIds": {
      "property1": "string",
      "property2": "string"
    },
    "errorMessage": "string",
    "profileId": "string",
    "userId": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "media": [
      {
        "id": "string",
        "postId": "string",
        "url": "string",
        "storagePath": "string",
        "type": "string",
        "filename": "string",
        "sizeBytes": 0,
        "sortOrder": 0,
        "createdAt": "2019-08-24T14:15:22Z"
      }
    ]
  }
}
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "string",
    "details": [
      {
        "field": "string",
        "message": "string"
      }
    ]
  }
}
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "string",
    "details": [
      {
        "field": "string",
        "message": "string"
      }
    ]
  }
}
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "string",
    "details": [
      {
        "field": "string",
        "message": "string"
      }
    ]
  }
}