Create post

curl --request POST \
  --url https://api.woopsocial.com/v1/posts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": [
    {
      "text": "<string>",
      "media": [
        {
          "type": "MEDIA_LIBRARY",
          "mediaId": "<string>"
        }
      ]
    }
  ],
  "schedule": {
    "type": "PUBLISH_NOW"
  },
  "socialAccounts": [
    {
      "platform": "FACEBOOK",
      "socialAccountId": "<string>",
      "postType": "IMAGE"
    }
  ]
}
'

{
  "id": "<string>",
  "projectId": "<string>",
  "content": [
    {
      "text": "<string>",
      "media": [
        {
          "type": "MEDIA_LIBRARY",
          "mediaId": "<string>",
          "mediaType": "IMAGE",
          "url": "<string>",
          "thumbnailUrl": "<string>"
        }
      ]
    }
  ],
  "schedule": {
    "type": "DRAFT"
  },
  "autoDeleteMediaAfterPublish": true,
  "socialAccountPosts": [
    {
      "platform": "PINTEREST",
      "socialAccountPostId": "<string>",
      "postId": "<string>",
      "projectId": "<string>",
      "socialAccountId": "<string>",
      "deliveryStatus": "NOT_STARTED",
      "content": [
        {
          "text": "<string>",
          "media": [
            {
              "type": "MEDIA_LIBRARY",
              "mediaId": "<string>",
              "mediaType": "IMAGE",
              "url": "<string>",
              "thumbnailUrl": "<string>"
            }
          ]
        }
      ],
      "schedule": {
        "type": "DRAFT"
      },
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "pinterestBoardId": "<string>",
      "deliveryCompletedAt": "2023-11-07T05:31:56Z",
      "externalPostId": "<string>",
      "externalPostUrl": "<string>",
      "errorMessage": "<string>",
      "title": "<string>",
      "link": "<string>"
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "retryPolicy": {
    "maxRetries": 3,
    "delaySeconds": 43230
  }
}

{
  "code": "INVALID_SOCIAL_ACCOUNT_ID",
  "message": "<string>",
  "validationErrors": [
    {
      "path": "<string>",
      "message": "<string>",
      "field": "DESCRIPTION"
    }
  ],
  "conflictingSocialAccountIds": [
    "<string>"
  ]
}

{
  "code": "TOO_MANY_CONCURRENT_REQUESTS",
  "message": "<string>"
}

{
  "code": "INVALID_SOCIAL_ACCOUNT_ID",
  "message": "<string>",
  "validationErrors": [
    {
      "path": "<string>",
      "message": "<string>",
      "field": "DESCRIPTION"
    }
  ],
  "conflictingSocialAccountIds": [
    "<string>"
  ]
}

POST

posts

curl --request POST \
  --url https://api.woopsocial.com/v1/posts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": [
    {
      "text": "<string>",
      "media": [
        {
          "type": "MEDIA_LIBRARY",
          "mediaId": "<string>"
        }
      ]
    }
  ],
  "schedule": {
    "type": "PUBLISH_NOW"
  },
  "socialAccounts": [
    {
      "platform": "FACEBOOK",
      "socialAccountId": "<string>",
      "postType": "IMAGE"
    }
  ]
}
'

{
  "id": "<string>",
  "projectId": "<string>",
  "content": [
    {
      "text": "<string>",
      "media": [
        {
          "type": "MEDIA_LIBRARY",
          "mediaId": "<string>",
          "mediaType": "IMAGE",
          "url": "<string>",
          "thumbnailUrl": "<string>"
        }
      ]
    }
  ],
  "schedule": {
    "type": "DRAFT"
  },
  "autoDeleteMediaAfterPublish": true,
  "socialAccountPosts": [
    {
      "platform": "PINTEREST",
      "socialAccountPostId": "<string>",
      "postId": "<string>",
      "projectId": "<string>",
      "socialAccountId": "<string>",
      "deliveryStatus": "NOT_STARTED",
      "content": [
        {
          "text": "<string>",
          "media": [
            {
              "type": "MEDIA_LIBRARY",
              "mediaId": "<string>",
              "mediaType": "IMAGE",
              "url": "<string>",
              "thumbnailUrl": "<string>"
            }
          ]
        }
      ],
      "schedule": {
        "type": "DRAFT"
      },
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "pinterestBoardId": "<string>",
      "deliveryCompletedAt": "2023-11-07T05:31:56Z",
      "externalPostId": "<string>",
      "externalPostUrl": "<string>",
      "errorMessage": "<string>",
      "title": "<string>",
      "link": "<string>"
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "retryPolicy": {
    "maxRetries": 3,
    "delaySeconds": 43230
  }
}

{
  "code": "INVALID_SOCIAL_ACCOUNT_ID",
  "message": "<string>",
  "validationErrors": [
    {
      "path": "<string>",
      "message": "<string>",
      "field": "DESCRIPTION"
    }
  ],
  "conflictingSocialAccountIds": [
    "<string>"
  ]
}

{
  "code": "TOO_MANY_CONCURRENT_REQUESTS",
  "message": "<string>"
}

{
  "code": "INVALID_SOCIAL_ACCOUNT_ID",
  "message": "<string>",
  "validationErrors": [
    {
      "path": "<string>",
      "message": "<string>",
      "field": "DESCRIPTION"
    }
  ],
  "conflictingSocialAccountIds": [
    "<string>"
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

content

object[]

required

Post content expressed as thread items.

The array exists for future thread support. Currently exactly one item is supported.

Required array length: 1 element

Show child attributes

schedule

Draft · object

required

When the post should be published.

Draft
Publish Now
Schedule For Later

Show child attributes

Social account targets for this post.

All referenced social accounts must belong to the same project. Duplicate socialAccountId values are invalid.

Minimum array length: 1

Show child attributes

autoDeleteMediaAfterPublish

boolean

default:false

When true, all media referenced by this post is automatically deleted from the media library after all social account deliveries for the post have published successfully.

retryPolicy

object

Automatic retry policy. Omit to disable automatic retries.

Show child attributes

Response

Post created.

string

required

Post identifier.

projectId

string

required

Project identifier that the selected social accounts belong to.

content

object[]

required

Post content expressed as thread items.

The array exists for future thread support. Currently exactly one item is returned.

Required array length: 1 element

Show child attributes

schedule

Draft · object

required

When the post should be published.

Draft
Publish Now
Schedule For Later

Show child attributes

autoDeleteMediaAfterPublish

boolean

required

Whether media auto-delete-after-publish is enabled for this post.

Platform-specific post instances.

Minimum array length: 1

Show child attributes

createdAt

string<date-time>

required

UTC time when the post was created.

updatedAt

string<date-time>

required

UTC time when the post was last updated.

retryPolicy

object

Automatically creates a scheduled retry post for each failed target. Successful targets are never copied. Known failures requiring user intervention, such as insufficient credits or disconnected accounts, are not automatically retried. If the platform published a post but its response was lost, retrying may produce a duplicate.

Show child attributes

Overview

Posts

Projects

Social Accounts

Media

Webhooks

Health

Authorizations

Body

Response