Quickstart

Create a key and make your first request.

You’ll have a working request in about two minutes.

1. Create a key

In your dashboard, open Configuration → Settings → API Keys and create one. You can give it full access, or just the permissions a particular integration needs — see Scopes & permissions.

You’ll see the key only once, right after you create it, so copy it somewhere safe like a secret manager. We can’t show it to you again. And keep it on your server — an API key should never end up in a browser, a mobile app, or anywhere a customer could find it.

A live key starts with sk_live_. In test environments it starts with sk_test_.

2. Make a request

Send your key as a Bearer token. Notice there’s no workspace in the URL — the key already knows which workspace it belongs to.

curl https://api.sentralbee.app/v1/products \
  -H "Authorization: Bearer sk_live_your_key_here"

It’s the same from any language: just set that Authorization header on your HTTP client.

3. Read the response

List endpoints give you back a page of items plus a little detail about the page:

{
	"items": [{ "id": "…", "name": "Demo product", "status": "ACTIVE" }],
	"page": 1,
	"size": 20,
	"total": 1,
	"total_pages": 1,
	"has_next_page": false,
	"has_previous_page": false
}

Where to next

• Authentication — how keys and headers work.
• Scopes & permissions — what a key is allowed to do.
• Errors — what a failure looks like.
• API reference — every endpoint in detail.