Docs
Posts
POST
/posts/{id}/publish

Publishes a draft or scheduled post right away. The post is checked like on create. Answers at once with status scheduled; follow the result with GET /posts/{id} or the post.published and post.failed webhooks.

Requires posts:write.

Authorization

bearerAuth
AuthorizationBearer <token>

API key starting with fh_

In: header

Path Parameters

id*string

Post id

Match^post_[0-9a-fA-F]{32}$

Header Parameters

Idempotency-Key?string

Any unique string up to 255 characters. A retry with the same key within 24 hours returns the first response instead of running again.

Lengthlength <= 255

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://feedhorizon.com/api/v1/posts/post_0195f0a27b3c7d4e8f5a1b2c3d4e5f60/publish"
{
  "data": {
    "id": "post_0195f0a27b3c7d4e8f5a1b2c3d4e5f60",
    "profileId": "prof_0195f0a27b3c7d4e8f5a1b2c3d4e5f60",
    "content": "string",
    "status": "draft",
    "source": "ui",
    "scheduledAt": "2019-08-24T14:15:22Z",
    "timezone": "string",
    "publishedAt": "2019-08-24T14:15:22Z",
    "idempotencyKey": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "targets": [
      {
        "id": "tgt_0195f0a27b3c7d4e8f5a1b2c3d4e5f60",
        "socialAccountId": "acc_0195f0a27b3c7d4e8f5a1b2c3d4e5f60",
        "accountName": "string",
        "platform": "twitter",
        "content": "string",
        "options": {
          "pinterest": {
            "boardId": "string",
            "title": "string",
            "link": "http://example.com"
          },
          "tiktok": {
            "privacyLevel": "PUBLIC_TO_EVERYONE",
            "allowComment": true,
            "allowDuet": true,
            "allowStitch": true,
            "brandOrganic": true,
            "brandedContent": true,
            "aiGenerated": true
          }
        },
        "status": "draft",
        "attempts": 0,
        "scheduledAt": "2019-08-24T14:15:22Z",
        "publishedAt": "2019-08-24T14:15:22Z",
        "platformPostId": "string",
        "platformUrl": "string",
        "error": {
          "code": "string",
          "category": "auth_expired",
          "source": "user",
          "message": "string"
        }
      }
    ],
    "media": [
      {
        "id": "med_0195f0a27b3c7d4e8f5a1b2c3d4e5f60",
        "url": "string",
        "mimeType": "string",
        "filename": "string",
        "sizeBytes": 0
      }
    ]
  }
}
{
  "error": {
    "type": "invalid_request_error",
    "code": "string",
    "message": "string",
    "param": "string",
    "details": [
      {
        "param": "string",
        "code": "string",
        "message": "string"
      }
    ],
    "docUrl": "http://example.com",
    "requestId": "string"
  }
}
{
  "error": {
    "type": "invalid_request_error",
    "code": "string",
    "message": "string",
    "param": "string",
    "details": [
      {
        "param": "string",
        "code": "string",
        "message": "string"
      }
    ],
    "docUrl": "http://example.com",
    "requestId": "string"
  }
}
{
  "error": {
    "type": "invalid_request_error",
    "code": "string",
    "message": "string",
    "param": "string",
    "details": [
      {
        "param": "string",
        "code": "string",
        "message": "string"
      }
    ],
    "docUrl": "http://example.com",
    "requestId": "string"
  }
}
{
  "error": {
    "type": "invalid_request_error",
    "code": "string",
    "message": "string",
    "param": "string",
    "details": [
      {
        "param": "string",
        "code": "string",
        "message": "string"
      }
    ],
    "docUrl": "http://example.com",
    "requestId": "string"
  }
}
{
  "error": {
    "type": "invalid_request_error",
    "code": "string",
    "message": "string",
    "param": "string",
    "details": [
      {
        "param": "string",
        "code": "string",
        "message": "string"
      }
    ],
    "docUrl": "http://example.com",
    "requestId": "string"
  }
}
{
  "error": {
    "type": "invalid_request_error",
    "code": "string",
    "message": "string",
    "param": "string",
    "details": [
      {
        "param": "string",
        "code": "string",
        "message": "string"
      }
    ],
    "docUrl": "http://example.com",
    "requestId": "string"
  }
}
{
  "error": {
    "type": "invalid_request_error",
    "code": "string",
    "message": "string",
    "param": "string",
    "details": [
      {
        "param": "string",
        "code": "string",
        "message": "string"
      }
    ],
    "docUrl": "http://example.com",
    "requestId": "string"
  }
}
{
  "error": {
    "type": "invalid_request_error",
    "code": "string",
    "message": "string",
    "param": "string",
    "details": [
      {
        "param": "string",
        "code": "string",
        "message": "string"
      }
    ],
    "docUrl": "http://example.com",
    "requestId": "string"
  }
}

Duplicate a post POST

Copies a post as a new draft with the same text, own texts per account, accounts and media. Works for published posts too, for example to post something again. Schedule the copy with `PATCH /posts/{id}`. Requires `posts:write`.

Retry a failed post POST

Puts the failed targets of the post back in line and publishes them right away. Requires `posts:write`.