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": "BLUESKY",
"socialAccountId": "<string>"
}
]
}
'{
"id": "<string>",
"projectId": "<string>",
"content": [
{
"text": "<string>",
"media": [
{
"type": "MEDIA_LIBRARY",
"mediaId": "<string>",
"mediaType": "IMAGE",
"url": "<string>",
"thumbnailUrl": "<string>",
"altText": "<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>",
"altText": "<string>"
}
]
}
],
"schedule": {
"type": "DRAFT"
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"metrics": {
"views": 123,
"impressions": 123,
"uniqueImpressions": 123,
"likes": 123,
"reactions": 123,
"comments": 123,
"shares": 123,
"saves": 123,
"clicks": 123,
"engagementRate": 123
},
"analytics": {
"views": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
],
"impressions": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
],
"uniqueImpressions": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
],
"likes": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
],
"reactions": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
],
"comments": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
],
"shares": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
],
"saves": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
],
"clicks": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
],
"engagementRate": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
]
},
"pinterestBoardId": "<string>",
"deliveryCompletedAt": "2023-11-07T05:31:56Z",
"externalPostId": "<string>",
"externalPostUrl": "<string>",
"errorMessage": "<string>",
"metricsCollectedAt": "2023-11-07T05:31:56Z",
"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>"
]
}Create post
Creates a (parent) post with one or more social account (child) posts.
All referenced social accounts must belong to the same project.
The request is validated atomically. If any social account fails validation, the post is not created.
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": "BLUESKY",
"socialAccountId": "<string>"
}
]
}
'{
"id": "<string>",
"projectId": "<string>",
"content": [
{
"text": "<string>",
"media": [
{
"type": "MEDIA_LIBRARY",
"mediaId": "<string>",
"mediaType": "IMAGE",
"url": "<string>",
"thumbnailUrl": "<string>",
"altText": "<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>",
"altText": "<string>"
}
]
}
],
"schedule": {
"type": "DRAFT"
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"metrics": {
"views": 123,
"impressions": 123,
"uniqueImpressions": 123,
"likes": 123,
"reactions": 123,
"comments": 123,
"shares": 123,
"saves": 123,
"clicks": 123,
"engagementRate": 123
},
"analytics": {
"views": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
],
"impressions": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
],
"uniqueImpressions": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
],
"likes": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
],
"reactions": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
],
"comments": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
],
"shares": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
],
"saves": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
],
"clicks": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
],
"engagementRate": [
{
"date": "2023-12-25",
"collectedAt": "2023-11-07T05:31:56Z",
"value": 123
}
]
},
"pinterestBoardId": "<string>",
"deliveryCompletedAt": "2023-11-07T05:31:56Z",
"externalPostId": "<string>",
"externalPostUrl": "<string>",
"errorMessage": "<string>",
"metricsCollectedAt": "2023-11-07T05:31:56Z",
"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
Body
Social account targets for this post.
All referenced social accounts must belong to the same project.
Duplicate socialAccountId values are invalid.
1- Bluesky
- Facebook
- Instagram
- LinkedIn
- LinkedIn Pages
- Pinterest
- Threads
- TikTok
- WoopTest
- X
- YouTube
Show child attributes
Show child attributes
Response
Post created.
Platform-specific post instances.
1- Pinterest
- Instagram
- Facebook
- Threads
- Bluesky
- TikTok
- YouTube
- X
- LinkedIn
- LinkedIn Pages
- WoopTest
Show child attributes
Show child attributes
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
Show child attributes
Was this page helpful?