Facebook Pixel tracker

Brand2Social API Documentation

Comprehensive guide to Brand2Social API endpoints

Create Customer API

This API endpoint allows you to create a new customer account along with one or more brands. You must provide user details for the primary admin and at least one brand object. The brand_image field is optional (URL to brand logo). On success, a redirect URL (login key) and the new customer ID are returned.

  • Method: POST
  • Endpoint: /api/api-services/v1/brand-service/create-customer
  • Authentication: Required (Bearer token from Authenticate User API)
  • Returns: Redirect URL and customer ID on success

Create Customer

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

Example Request Body (JSON)

Visual examples of similar API requests in tools like Postman and cURL:

FieldTypeRequiredDescription
user_detailsobjectYesPrimary user/admin details
FieldTypeRequiredDescription
email_addressstringYesUser's email (used for login)
passwordstringYesUser's password
timezonestringYese.g., "Asia/Kolkata"
first_namestringYesUser's first name
brand_detailsarray[object]Yes (min 1)List of brands to create
FieldTypeRequiredDescription
brand_namestringYesName of the brand
brand_imagestringNoURL to brand logo/image
timezonestringYesBrand's timezone
brand_limitationobjectYesUsage limits for the brand
FieldTypeRequiredDescription
social_account_limitintegerYesMax social accounts
users_limitintegerYesMax users
ai_content_tokensintegerYesAI content generation tokens
ai_image_tokenintegerYesAI image generation tokens
curl --location 'https://app.brand2social.com/api/api-services/v1/brand-service/create-customer' \
    --header 'Authorization: Bearer B2S_dummyToken' \
    --header 'Content-Type: application/json' \
    --data-raw '{
      "user_details": {
        "email_address": "demo@example.com",
        "password": "demo@example.com",
        "timezone": "Asia/Kolkata",
        "first_name": "Demo"
      },
      "brand_details": [
        {
          "brand_name": "DemoBrand",
          "brand_image": "https://example.com/logo.png",
          "timezone": "Asia/Kolkata",
          "brand_limitation": {
            "social_account_limit": 1,
            "users_limit": 1,
            "ai_content_tokens": 1,
            "ai_image_token": 1
          }
        }
      ]
    }'

Response

{
  "status": "SUCCESS",
  "http_code": 200,
  "message": "Successfully created new customer",
  "data": {
    "redirect_url": "https://app.brand2social.com/login?login_key=unique-login-key",
    "customer_id": "cust_abc123xyz"
  }
}

Note: This endpoint is typically used by resellers or agencies to provision new client accounts programmatically.