Skip to main content

Overview

The bitbybit Open API provides programmatic access to your bitbybit data. You can manage customers, orders, and products through a RESTful API secured with API key authentication.

Base URLs

Quick Start

  1. Go to Settings > Developer in your bitbybit dashboard
  2. Click Create API Key and select the scopes you need
  3. Copy the API key (it’s only shown once)
  4. Include it in every request via the x-api-key header

Response Format

Success (single resource):
Success (collection):
Error:

Phone number format

Always send phone numbers in full international format: country code included, no leading +, and no spaces or dashes. Messaging endpoints also accept an optional countryCode (ISO 3166-1 alpha-2, such as ID or MY) that resolves a number still written in local format. Treat it as a fallback — a number that already carries its country code needs no extra field.
Send countryCode only when it matches the number. Pairing a number that already carries its own country code with a different countryCode rewrites it into the wrong country.
A local-format number sent without countryCode is passed through unchanged, so the request is accepted but the message cannot be delivered. Indonesian numbers beginning 08 are the one exception: they are resolved to +62 automatically.

Available Resources

Customers

Create, read, update, and delete customers

Orders

Manage orders and fulfillment

Products

Manage your product catalog

Messaging

Send and track WhatsApp messages

Loyalty

Manage loyalty settings, points, rewards, and redemptions

Webhooks

Receive real-time event notifications