Brand2Social API Documentation

Comprehensive guide to Brand2Social API endpoints

Get Scheduled Event Info

POST https://app.brand2social.com/api/api-services/v1/brand-service/scheduled-event-info

Retrieve details of specific scheduled social media posts. Specify the brand_id and an array of schedule_post_ids (from create-new-post) in the request body. Returns platform-specific details (e.g., media URLs, post type, status) for supported platforms: Facebook, Instagram, TikTok, Google My Business, YouTube, LinkedIn, Twitter, Pinterest. Requires ORG_ADMIN permission and view schedule permissions.

Request Body

ParameterTypeRequiredDescription
Authorizationstring (header)YesBearer token for authentication (requires ORG_ADMIN permission)
brand_idint64 (body)YesID of the brand
schedule_post_ids[]int64 (body)YesArray of scheduled post IDs (from create-new-post)

Example Request

    
    
curl --location 'https://app.brand2social.com/api/api-services/v1/brand-service/scheduled-event-info' \
  --header 'Authorization: Bearer B2S_dummyToken' \
  --header 'Content-Type: application/json' \
  --data '{
    "brand_id": 123,
    "schedule_post_ids": [2615]
}'
    
  

Response

{
  "status": "SUCCESS",
  "http_code": 200,
  "message": "Fetched all Scheduled events successfully",
  "data": [
    {
      "scheduled_event_response_data": {
        "facebook_response_data": [
          {
            "id": 1295,
            "media_urls": [
              "https://example.com/media/photo.png"
            ],
            "description": "Amazing photo post",
            "link": "",
            "completed": true,
            "schedule_post_id": 2615,
            "post_type": "post",
            "failed": true,
            "failure_reason": "Post failed: server not found",
            "updated_at": "2025-07-18T06:12:48Z",
            "post_id": "",
            "connected_profile_details": {
              "connected_profile_id": 512,
              "profile_id": "231845643347841",
              "connected_profile_image": "https://example.com/profile.jpg",
              "connected_profile_name": "Jce boys 2020",
              "social_media": "Facebook"
            },
            "has_comment": true,
            "comment_description": "Join the conversation!",
            "comment_media_url": "",
            "thumbnail": "https://example.com/thumbnail.jpg"
          }
        ],
        "instagram_response_data": [
          {
            "id": 784,
            "media_urls": [
              "https://example.com/media/insta.png"
            ],
            "cover_url": "",
            "description": "New post on Instagram! #InstaVibes",
            "completed": true,
            "schedule_post_id": 2615,
            "post_type": "post",
            "failed": true,
            "failure_reason": "Token expired",
            "updated_at": "2025-07-18T06:12:48Z",
            "post_id": "",
            "connected_profile_details": {
              "connected_profile_id": 444,
              "profile_id": "17841462493751356",
              "connected_profile_image": "https://example.com/insta_profile.jpg",
              "connected_profile_name": "feedthe.needs",
              "social_media": "Instagram"
            },
            "has_comment": true,
            "comment_description": "What do you think?",
            "comment_media_url": "",
            "post_on_my_wall": false
          }
        ],
        "gbusiness_response_data": [
          {
            "id": 203,
            "media_urls": [
              "https://example.com/media/offer.png"
            ],
            "description": "New offer at our store!",
            "completed": true,
            "schedule_post_id": 2615,
            "post_type": "OFFER",
            "failed": false,
            "failure_reason": "",
            "updated_at": "2025-07-18T06:12:48Z",
            "post_id": "",
            "title": "Special Discount",
            "button_type": "BOOK",
            "start_date": "2025-07-20T00:00:00Z",
            "end_date": "2025-07-25T23:59:59Z",
            "start_time": "2025-07-20T09:00:00Z",
            "end_time": "2025-07-25T18:00:00Z",
            "offer_code": "DISCOUNT2025",
            "terms_conditions": "Valid for in-store purchases only.",
            "url": "https://example.com/offer",
            "connected_profile_details": {
              "connected_profile_id": 397,
              "profile_id": "7216608309138085372",
              "connected_profile_image": "",
              "connected_profile_name": "Brand2Social",
              "social_media": "GBusiness"
            }
          }
        ],
        "linkedin_response_data": [
          {
            "id": 414,
            "media_urls": [
              "https://example.com/media/video.mp4"
            ],
            "description": "Exciting update from our company!",
            "completed": true,
            "schedule_post_id": 2615,
            "post_type": "post",
            "failed": false,
            "title": "",
            "failure_reason": "",
            "updated_at": "2025-07-18T06:12:48Z",
            "post_id": "urn:li:ugcPost:7351857258424647682",
            "profile_type": "",
            "connected_profile_details": {
              "connected_profile_id": 428,
              "profile_id": "104858016",
              "connected_profile_image": "",
              "connected_profile_name": "kumar",
              "social_media": "Linkedin"
            },
            "has_comment": false,
            "comment_description": "",
            "comment_media_url": ""
          }
        ],
        "tiktok_response_data": [],
        "youtube_response_data": [],
        "twitter_response_data": [],
        "pinterest_response_data": []
      },
      "media_url": "",
      "scheduled_time": "2025-07-18T06:12:48Z",
      "description": "Multi-platform social media post",
      "schedule_post_id": 2615,
      "comment_description": "Join our campaign!"
    }
  ]
}

Error Response

{
  "status": "FAILURE",
  "http_code": 400,
  "message": "Invalid request payload for Update New Post API",
  "data": ""
}
{
  "status": "FAILURE",
  "http_code": 400,
  "message": "schedule_post_id is required",
  "data": ""
}
{
  "status": "FAILURE",
  "http_code": 400,
  "message": "brand_id is required",
  "data": ""
}
{
  "status": "FAILURE",
  "http_code": 500,
  "message": "Error in Get Scheduled Events API",
  "data": ""
}