SpotBay - Retail Marketing & Loyalty Platform
Home
Platform

Retail Marketing & Loyalty Platform

Modules that work together

Platform Overview
One integrated retail marketing & loyalty platform
Loyalty & Rewards Engine
Points, tiers, and rewards that drive repeat visits
POS & Billing
Unified point-of-sale and billing
WhatsApp Marketing & Campaigns
Campaigns and broadcasts on WhatsApp
AI Chatbots & Automation
WhatsApp bots and automated flows
Customer Insights & Product Analytics
Behavior and product analytics
Contests & Gamification
Quiz, spin the wheel, scratch & win, tournaments
Reviews & Feedback (Google Reviews)
Collect and manage reviews
E-commerce Storefront
Online storefront for orders
Chat Support via WhatsApp
Helpdesk and support on WhatsApp
Solutions

Solutions by Industry

Tailored for restaurants, retail, salons, and more

Restaurants & Cafes
Purpose-built for F&B
Retail & E-commerce
From browse to repeat buy
Salons & Spas
Appointments that rebook
Supermarkets & Grocers
Offers that move volume
Healthcare & Wellness
Care that follows up
Education & Training
Engage students and parents
Real Estate
Listings that convert
Banks & Service Counters
Queues that move faster
WhatsApp Marketing Agencies
Scale your agency
Products

Our Products

Complete customer engagement solutions

View All →

Engagement & Growth

Customer Loyalty Programs
Build lasting customer relationships with rewards
Referral Programs
Turn customers into brand advocates
Gamification
Game-like elements for engagement

Marketing & Automation

WhatsApp Marketing
Direct customer communication via WhatsApp
Marketing Campaigns
Targeted campaigns to drive engagement
Automated Campaigns & Bots
AI chatbots and automation workflows
Contests & Competitions
Quiz, spin the wheel, scratch & win

Analytics, Tech & More

POS & Billing
Unified POS and billing for retail
Customer Insights
Deep insights into customer behavior
Smart QR Codes
Interactive QR codes for engagement
Feedback & Reviews
Manage reviews and collect feedback
E-commerce Storefront
Online storefront for orders
WhatsApp Support / Helpdesk
Chat support via WhatsApp
Social Media Integration
Connect social media with customer data
PricingDevelopers
Resources
BlogGuidesCase Studies
Company
AboutContactCareersPartner Program
Developer Platform

SpotBay WhatsApp API

Send WhatsApp messages, manage templates, and handle media — all through a single, simple API.

Generate your API token in the Business Portal (Operate → Settings → Developer API), point your requests to bbgateway.spotbay.in/wa-api, and start sending. Full WhatsApp Cloud API payload compatibility — no changes to your message structure needed.

Quick Start Postman Collection Postman Environment OpenAPI Spec
send-message.sh
# Send a WhatsApp message
curl -X POST \
  'https://bbgateway.spotbay.in/wa-api/v21.0/<phone_id>/messages' \
  -H 'Authorization: Bearer sb_wa_your_token' \
  -d &apos;{
    "messaging_product": "whatsapp",
    "to": "919876543210",
    "type": "text",
    "text": {"body": "Hello! 👋"}
  }&apos;

Business Portal → Operate → Settings → Developer API. Start sending in minutes.

⚡

Simple Integration

One token, one base URL. Follow the WhatsApp Cloud API spec — send messages, manage templates, upload media. No complicated setup.

🛡️

Managed for You

SpotBay handles authentication, rate limits, and reliability. Your token is all you need to get started.

📦

Full Message Type Support

Text, images, video, audio, documents, interactive buttons, lists, templates, reactions — the complete WhatsApp Cloud API message surface.

Quick Start

Send your first message in 60 seconds

Get your SpotBay API token from the Business Portal → Operate → Settings → Developer API.

curl -X POST 'https://bbgateway.spotbay.in/wa-api/v21.0/{phone_number_id}/messages' \
  -H 'Authorization: Bearer sb_wa_your_token' \
  -H 'Content-Type: application/json' \
  -d '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "919876543210",
    "type": "text",
    "text": {
      "preview_url": false,
      "body": "Hello from SpotBay! 👋"
    }
  }'
API Reference

Supported Endpoints

SpotBay API follows the WhatsApp Cloud API v21.0 spec, plus one SpotBay extension for downloading media. For full payload details on each endpoint, refer to the WhatsApp Cloud API docs — request and response formats are identical.

POST/v21.0/{phone_number_id}/messagesSend any message type
POST/v21.0/{phone_number_id}/mediaUpload media
GET/v21.0/{media_id}Get media metadata
GET/v21.0/{media_id}/downloadDownload media bytes (SpotBay extension)
DELETE/v21.0/{media_id}Delete media
GET/v21.0/{waba_id}/message_templatesList templates
POST/v21.0/{waba_id}/message_templatesCreate template
DELETE/v21.0/{waba_id}/message_templates?name=...Delete template by name
GET/v21.0/{waba_id}/phone_numbersList phone numbers
GET/v21.0/{waba_id}Get WABA details
GET/v21.0/{phone_number_id}Get phone number details
GET/v21.0/{phone_number_id}/whatsapp_business_profileGet business profile
POST/v21.0/{phone_number_id}/whatsapp_business_profileUpdate business profile
Authentication

How authentication works

Include your SpotBay API token in every request:

Authorization: Bearer sb_wa_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Find your token: Business Portal → Operate → Settings → Developer API

Where to getBusiness Portal → Operate → Settings → Developer API
HeaderAuthorization: Bearer <token>
ScopeOne phone number + its WABA; rotate or revoke any time
Keep secretDo not expose in client-side code
Errors & Limits

Two error families, one JSON envelope

Errors raised by SpotBay carry type: "SpotBayApiError", the HTTP status in code and a machine-readable spotbay_reason. Errors from Meta pass through unchanged with Meta's status code and fbtrace_id. Every error is application/json.

{
  "error": {
    "message": "waba_id 000000000000000 does not belong to this API token",
    "type": "SpotBayApiError",
    "code": 403,
    "spotbay_reason": "waba_mismatch"
  }
}
Rate limit300 requests / minute / token
Body size50 MB for a media upload, 1 MB for every other request; downloads are streamed
Uploads4 buffered at once per instance, then 503 busy + Retry-After: 2
Timeout55 s upstream
Meta errorsPassed through unchanged, with Meta's status + fbtrace_id
401invalid_tokenMissing, malformed, rotated or revoked token
403phone_number_mismatchphone_number_id in the path is not the token's number
403waba_mismatchwaba_id in the path is not the token's WABA
403endpoint_not_availableA Meta edge SpotBay does not proxy (/register, /subscribed_apps, …)
404unknown_pathPath is not /{version}/{id}[/{resource}], or an id is not 1–32 digits
404media_not_foundMedia lookup on a numeric id that is not one of your media objects
405method_not_allowedWrong HTTP method for a known edge
413payload_too_largeBody over the limit — 50 MB for a media upload, 1 MB for any other request
429rate_limitedOver 300 requests per minute on this token — honour Retry-After
503busyMore than 4 media uploads buffering on the instance — retry after Retry-After (2 s)
502upstream_unreachableMeta could not be reached
502upstream_response_too_largeMeta's JSON reply is larger than SpotBay buffers
504upstream_timeoutMeta did not answer within 55 s

Webhooks

Coming soon

Inbound messages and delivery-status callbacks are not available on the Developer API yet — there is no webhook endpoint to configure. Sending, templates, media and business-profile management are fully available today. Tell us if you need webhooks and we will let you know as soon as they ship.

Contact dev@spotbay.in

Ready to integrate?

Sign up for SpotBay, connect your WhatsApp Business Account, and generate your API token in minutes.

Get Started FreeContact Developer Support
SpotBay Logo - WhatsApp CRM for RestaurantsSpotBay

AI-powered retail marketing & loyalty platform for restaurants, retail, salons, clinics, and more in India, UAE & GCC.

Platform & Products

Platform OverviewLoyalty & RewardsWhatsApp MarketingView All Products →

Solutions & Resources

Solutions by IndustryPricingBlogGuidesCase Studies

Company

HomeAboutContactCareersPartner ProgramContact Support

Contact Info

+91 85929 47700
hello@spotbay.in
SpotBay Global Private Limited
Kochi, Kerala, India

© 2026 SpotBay Global Private Limited. All rights reserved. Retail Marketing & Loyalty Platform for restaurants, retail, and service businesses in India, UAE & GCC.

Privacy PolicyTerms of Service

SpotBay - Retail Marketing & Loyalty Platform for Restaurants, Retail, Salons, Clinics

SpotBay is an AI-powered retail marketing and loyalty platform: loyalty engine, POS, WhatsApp marketing, reviews, contests, e-commerce storefront, and chat support. Built for restaurants, retail, salons, clinics, supermarkets, and service businesses in India, UAE, and GCC. WhatsApp Marketing CRM, loyalty programs, and customer engagement in one platform.