Baseplate Docs

Quickstart

From zero to your first authenticated API call in under five minutes.

By the end of this page you'll have issued a personal access token and listed your products with curl. Total time: 3-5 minutes.

1. Open the dashboard

Sign in at bp.mobicms.com.br and switch into the store you want to script against. The store name appears in the top-left of the sidebar.

2. Create a personal access token

Open API tokens in the sidebar (under your team / settings group).

Click New token. Three things to fill in:

  • Name — anything you'll recognize later. "laptop curl" is fine.
  • Permissions — check only the ones you need. For this walkthrough, products.read is enough.
  • Expiry — leave blank for now.

Hit Create. You'll see the raw token exactly once:

bod_8aF3K2…NvWp

Copy it now

Baseplate only stores a hash of the token. If you close the dialog without copying it, the only recourse is Rotate (or revoke and create a new one).

3. Find your store ID

The dashboard URL has it. While viewing any page inside your store, look at the network panel and grep for /stores/<uuid> — that UUID is your store ID. You'll need it in every URL below.

Or pull it from the API once you have a token:

curl -s https://bp.mobicms.com.br/tenants \
  -H "Authorization: Bearer $BP_TOKEN" | jq '.[].id'

4. Make your first call

export BP_TOKEN="bod_8aF3K2…NvWp"
export STORE_ID="00000000-0000-0000-0000-000000000000"

curl -s "https://bp.mobicms.com.br/stores/$STORE_ID/products?limit=5" \
  -H "Authorization: Bearer $BP_TOKEN" \
  | jq '.products[].title'

If your scope includes products.read, this prints the first 5 product titles. If it doesn't, you'll get a 403 — go back to the tokens page, rotate or revoke and reissue with the right scope.

5. Common follow-ups

On this page