Retrieve all scheduled social media posts for a brand within a specified date range.create-new-post for platforms like Facebook, Instagram, LinkedIn, Twitter, YouTube, Google Business, TikTok, and Pinterest. The response includes post details, status, and connected profile information. The schedule_post_id can be used with update-new-post or delete-new-post. Requires brand_id and valid date range (from, to).
Method: POST Endpoint: /api/api-services/v1/brand-service/get-all-calendar-postReturns: List of scheduled posts with detailsPOST
https://app.brand2social.com/api/api-services/v1/brand-service/get-all-calendar-post
Field Type Required Description Authorization string (header) Yes Bearer token for authentication brand_id int64 (query) Yes ID of the brand from string (query, ISO 8601) Yes Start of the date range (e.g., "2025-08-01T00:00:00.000Z") to string (query, ISO 8601) Yes End of the date range (e.g., "2025-08-31T23:59:59.999Z") sort_by string (query) No Field to sort by (e.g., "scheduled_time") sort_order string (query) No Sort direction (e.g., "asc", "desc")
curl --location 'https://app.brand2social.com/api/api-services/v1/brand-service/get-all-calendar-post?brand_id=123&from=2025-08-01T00:00:00.000Z&to=2025-08-31T23:59:59.999Z&sort_by=scheduled_time&sort_order=asc' \
--header 'Authorization: Bearer B2S_dummyToken'
Response {
"status": "SUCCESS",
"http_code": 200,
"message": "",
"data": [
{
"id": 456,
"created_by": {
"name": "John Doe",
"email": "john.doe@example.com",
"profile_pic": "https://example.com/profile.jpg"
},
"title": "Product Launch Post",
"description": "Announcing our new product!",
"is_file_upload": true,
"scheduled_time": "2025-08-20T14:30:00.000Z",
"updated_at": "2025-08-19T15:00:00.000Z",
"status": "SCHEDULED",
"media_url": "https://example.com/media.jpg",
"is_enabled": true,
"is_approved": true,
"is_rejected": false,
"has_edit_access": true,
"has_delete_access": true,
"has_approve_access": false,
"approved_by": {
"name": "Jane Smith",
"email": "jane.smith@example.com",
"profile_pic": "https://example.com/jane.jpg"
},
"rejected_by": {
"name": "",
"email": "",
"profile_pic": ""
},
"created_time": "2025-08-18T10:00:00.000Z",
"status_code": 1,
"connected_profile_details": [
{
"connected_profile_id": 98765,
"profile_id": "fb_12345",
"connected_profile_image": "https://example.com/fb_profile.jpg",
"connected_profile_name": "Brand Page",
"social_media": "facebook",
"webhook_profile_id": 1001
},
{
"connected_profile_id": 98766,
"profile_id": "insta_67890",
"connected_profile_image": "https://example.com/insta_profile.jpg",
"connected_profile_name": "Brand Insta",
"social_media": "instagram",
"webhook_profile_id": 1002
}
]
}
]
}Response Fields Field Type Description id int64 Unique ID of the scheduled post (use with update-new-post or delete-new-post) created_by object User who created the post Field Type Description name string Name of the user email string Email of the user profile_pic string URL of the user’s profile picture
title string Title of the post description string Content of the post is_file_upload boolean Whether the post includes uploaded media scheduled_time string (ISO 8601) Scheduled time of the post updated_at string (ISO 8601) Last update time of the post status string Post status (e.g., "SCHEDULED", "POSTED", "FAILED") media_url string URL of the media associated with the post is_enabled boolean Whether the post is enabled is_approved boolean Whether the post is approved is_rejected boolean Whether the post is rejected has_edit_access boolean Whether the user has edit access has_delete_access boolean Whether the user has delete access has_approve_access boolean Whether the user has approval access approved_by object User who approved the post (empty if not approved) Field Type Description name string Name of the approver email string Email of the approver profile_pic string URL of the approver’s profile picture
rejected_by object User who rejected the post (empty if not rejected) Field Type Description name string Name of the rejector email string Email of the rejector profile_pic string URL of the rejector’s profile picture
created_time string Creation time of the post status_code int64 Numeric code for post status connected_profile_details array of objects Details of connected social media profiles Field Type Description connected_profile_id int64 ID of the connected profile (from integrate-accounts) profile_id string Social media profile ID connected_profile_image string URL of the profile image connected_profile_name string Name of the profile social_media string Platform (e.g., "facebook", "instagram") webhook_profile_id int64 Webhook profile ID
Error Response {
"status": "FAILURE",
"http_code": 400,
"message": "Error in fetching calendar events",
"data": ""
}