ExtensionsBuiltByBit
Configuration
Every BuiltByBit setting and what it does.
BuiltByBit's settings live in config/builtbybit/config.json under BUILTBYBIT. The file is created
for you and self-heals, so anything you leave out is filled back in with its default. Restart Kora
after editing.
Settings
| Setting | Default | Description |
|---|---|---|
API_TOKEN | "" | Your BuiltByBit API token. Required for the poller to read your sales. |
RESOURCES | [] | The resources to sync. See below. |
WEBHOOK_SECRET | "" | The secret used to verify incoming BuiltByBit webhooks. |
POLL.ENABLE | true | Turn the reconciliation poller on or off. |
POLL.INTERVAL | 5m | How often to poll for new purchases. |
POLL.INITIAL | latest | On first run, start from the latest purchase or backfill all. |
CLAIM.MODE | auto-link | How new purchases become licenses: auto-link or unclaimed-key. |
Durations use a number plus a unit: ms, s, m, or h.
Resources
Each entry in RESOURCES maps one BuiltByBit resource to a Kora product:
| Field | Description |
|---|---|
RESOURCE_ID | The BuiltByBit resource id. |
PRODUCT | The Kora product to issue a license for. |
ADDONS | Addons to grant on the issued license. |
{
"BUILTBYBIT": {
"API_TOKEN": "your-token",
"RESOURCES": [
{
"RESOURCE_ID": "78901",
"PRODUCT": "Your Product",
"ADDONS": ["Full Source"]
}
],
"WEBHOOK_SECRET": "a-long-random-secret",
"POLL": {
"ENABLE": true,
"INTERVAL": "5m",
"INITIAL": "latest"
},
"CLAIM": {
"MODE": "auto-link"
}
}
}CLAIM.MODE is explained on the Setup page, and the claim endpoint
is on the API Reference.