curl --request PATCH \
--url https://api.woopsocial.com/v1/social-account-posts/{socialAccountPostId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"content": [
{
"text": "<string>",
"media": [
{
"type": "MEDIA_LIBRARY",
"mediaId": "<string>"
}
]
}
]
}
'{
"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>"
}{
"code": "SOCIAL_ACCOUNT_POST_NOT_FOUND",
"message": "<string>",
"deliveryStatus": "NOT_STARTED",
"validationErrors": [
{
"path": "<string>",
"message": "<string>",
"field": "DESCRIPTION"
}
]
}{
"code": "SOCIAL_ACCOUNT_POST_NOT_FOUND",
"message": "<string>",
"deliveryStatus": "NOT_STARTED",
"validationErrors": [
{
"path": "<string>",
"message": "<string>",
"field": "DESCRIPTION"
}
]
}{
"code": "SOCIAL_ACCOUNT_POST_NOT_FOUND",
"message": "<string>",
"deliveryStatus": "NOT_STARTED",
"validationErrors": [
{
"path": "<string>",
"message": "<string>",
"field": "DESCRIPTION"
}
]
}{
"code": "TOO_MANY_CONCURRENT_REQUESTS",
"message": "<string>"
}{
"code": "SOCIAL_ACCOUNT_POST_NOT_FOUND",
"message": "<string>",
"deliveryStatus": "NOT_STARTED",
"validationErrors": [
{
"path": "<string>",
"message": "<string>",
"field": "DESCRIPTION"
}
]
}Update social account post
Updates the content or schedule of one social account post.
Only a social account post whose deliveryStatus is NOT_STARTED can
be updated. Its ID stays the same.
Each field you send replaces that whole field. Fields you omit stay
unchanged. The result is validated with the same rules as
POST /posts.
The parent post’s content and schedule don’t change. They are only
defaults: each social account post publishes its own content on its own
schedule.
curl --request PATCH \
--url https://api.woopsocial.com/v1/social-account-posts/{socialAccountPostId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"content": [
{
"text": "<string>",
"media": [
{
"type": "MEDIA_LIBRARY",
"mediaId": "<string>"
}
]
}
]
}
'{
"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>"
}{
"code": "SOCIAL_ACCOUNT_POST_NOT_FOUND",
"message": "<string>",
"deliveryStatus": "NOT_STARTED",
"validationErrors": [
{
"path": "<string>",
"message": "<string>",
"field": "DESCRIPTION"
}
]
}{
"code": "SOCIAL_ACCOUNT_POST_NOT_FOUND",
"message": "<string>",
"deliveryStatus": "NOT_STARTED",
"validationErrors": [
{
"path": "<string>",
"message": "<string>",
"field": "DESCRIPTION"
}
]
}{
"code": "SOCIAL_ACCOUNT_POST_NOT_FOUND",
"message": "<string>",
"deliveryStatus": "NOT_STARTED",
"validationErrors": [
{
"path": "<string>",
"message": "<string>",
"field": "DESCRIPTION"
}
]
}{
"code": "TOO_MANY_CONCURRENT_REQUESTS",
"message": "<string>"
}{
"code": "SOCIAL_ACCOUNT_POST_NOT_FOUND",
"message": "<string>",
"deliveryStatus": "NOT_STARTED",
"validationErrors": [
{
"path": "<string>",
"message": "<string>",
"field": "DESCRIPTION"
}
]
}Authorizations
Path Parameters
Body
The fields to change. Each field you send replaces that whole field. Fields you omit stay unchanged. At least one field is required.
Response
Social account post updated.
- Pinterest
- Instagram
- Facebook
- Threads
- Bluesky
- TikTok
- YouTube
- X
- LinkedIn
- LinkedIn Pages
- WoopTest
Delivery lifecycle status for a post.
NOT_STARTED: The post exists and is scheduled, but delivery has not started yet.
SENDING: Delivery is currently in progress.
PUBLISHED: Delivery completed successfully.
FAILED: Delivery completed unsuccessfully.
NOT_STARTED, SENDING, PUBLISHED, FAILED Deprecated: use metrics, which holds the same latest values as plain
numbers.
Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data.
Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported.
Show child attributes
Show child attributes
Was this page helpful?