Quickstart

Create a test secret key, check a licence key from your server, and switch to live when you're ready.

Before you start

  • Early access to the maker console, with your organisation set up.
  • A product of yours listed on Ploba, and a licence key from a test subscription to it.
  • The Owner or Admin role in your organisation (only they can create keys).

Steps

  1. Create a test secret key

    In the console, open Settings → API keys and create a key with the test environment. Copy it straight away: it’s shown once.
  2. Store it on your server

    Keep it in an environment variable such as PLOBA_SECRET_KEY. Never ship it in a browser, an app bundle or a public repository.
  3. Verify a licence key

    Send the user’s licence key to POST /verify-license:
curl -X POST https://api.ploba.app/api/v1/external/developer/verify-license \
  -H "Authorization: Bearer $PLOBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "licenseKey": "<the user's licence key>" }'
  1. Read the response

    200 means the licence is active; data says which product and plan it belongs to. 404 means there’s no active licence with that key for your organisation: refuse the request.
  2. Go live

    Create a live key and swap it in. Nothing else changes. Then report usage if you charge per call.

Last updated Oct 9, 2026Report a problem with this page