Facebook Pixel tracker

Brand2Social API Documentation

Comprehensive guide to Brand2Social API endpoints

Update Brand API

This API endpoint allows authorized organization admins to update an existing brand's details (name, image, timezone, or usage limits). The brand must belong to your authorized brands. brand_image URLs are validated and processed through the internal image server. AI content tokens are multiplied by 100 internally.

  • Method: POST (implemented as POST with JSON body)
  • Endpoint: /api/api-services/v1/brand-service/update-brand
  • Authentication: Required (Bearer token with ORG_ADMIN permissions)
  • Returns: Success message on update

Update Brand

POST https://app.brand2social.com/api/api-services/v1/brand-service/update-brand

Example Request Body (JSON)

How an update request appears in Postman and other API clients:

FieldTypeRequiredDescription
brand_idintegerYesNumeric ID of the brand to update (must be > 0 and authorized)
brand_namestringNoNew brand name (optional)
brand_imagestringNoURL to new brand logo (must be valid image; processed internally)
timezonestringNoNew timezone (e.g., "Asia/Kolkata")
brand_limitationobjectNoUpdated limits
FieldTypeRequiredDescription
social_account_limitintegerNoMax social accounts
users_limitintegerNoMax users
ai_content_tokensintegerNoAI content tokens (value multiplied by 100 internally)
ai_image_tokenintegerNoAI image tokens
curl --location --request POST 'https://app.brand2social.com/api/api-services/v1/brand-service/update-brand' \
    --header 'Authorization: Bearer B2S_dummyToken' \
    --header 'Content-Type: application/json' \
    --data-raw '{
      "brand_id": 4722,
      "brand_name": "UpdatedMyBrand",
      "brand_image": "https://example.com/new-logo.png",
      "timezone": "Asia/Kolkata",
      "brand_limitation": {
        "social_account_limit": 5,
        "users_limit": 3,
        "ai_content_tokens": 5000,
        "ai_image_token": 1000
      }
    }'

Success Response

Typical successful response in Postman:

{
  "status": "SUCCESS",
  "http_code": 200,
  "message": "Successfully updated brand",
  "data": null
}

Notes:
• Only fields provided will be updated — omit to keep existing values.
• Invalid brand_image URLs will return an error.
• Use "Get All Brands from Customer" first to retrieve valid brand_id values.
• This endpoint is restricted to organization admins with permission on the target brand.