​
BuiltByBit Integration

Lukittu automatically delivers licenses to your customers when they purchase through BuiltByBit.

​
Implementation Overview

Follow these steps to configure licensing for the products you sell using BuiltByBit:
1

Create a product in Lukittu

First, set up your product in the Lukittu platform.
2

Enable the BuiltByBit integration

Activate the integration in your Lukittu dashboard.
3

Set up a purchase webhook

Configure BuiltByBit to notify Lukittu of purchase events.
4

Create a license placeholder

Set up automatic license delivery for your customers.

​
Creating a Product in Lukittu

1

Navigate to Products

Go to the Products page in your Lukittu dashboard and click Add Product.
2

Add product details

Enter a name for your product and click Save.
3

Get the product ID

Open the page for your newly created product and copy the product’s ID.
You’ll need this ID when configuring your BuiltByBit webhook.

​
Enabling BuiltByBit Integration

Before setting up webhooks on BuiltByBit, you need to enable the integration in your Lukittu dashboard:
1

Access Integrations Settings

Log in to your Lukittu dashboard and navigate to the Integrations tab.
2

Enable the Integration

Locate the BuiltByBit integration option and toggle it to Active.
3

Copy the Secret

Copy the generated Secret as you’ll need it for the webhook setup.
Keep this secret secure as it authenticates your webhook requests.

​
Setting Up Purchase Webhook

Follow these steps to configure the purchase webhook that will automatically issue licenses:
1

Access BuiltByBit Webhooks

Go to the BuiltByBit webhooks dashboard and click the Create webhook button.
2

Configure Webhook Settings

Enter a descriptive name for the webhook. Select Purchase from the Trigger dropdown. Choose Only apply to certain resources and select the specific resource(s) you want to license.
3

Set Webhook URL

Enter the following URL:
https://app.lukittu.com/api/v1/integrations/built-by-bit?teamId=YOUR_TEAM_ID
Replace YOUR_TEAM_ID with your Lukittu team’s ID.
To find your Team ID, go to the Lukittu dashboard and navigate to Team → Settings.
4

Configure Webhook Format

Select Custom for Template, POST for Method, and application/json for Content Type.
5

Set Webhook Body

Copy and paste the following JSON template:
{
    "apiSecret": "YOUR_BUILT_BY_BIT_SECRET",
    "builtByBitData": {
        "user": {
            "id": "{user_id}",
            "username": "{username}",
            "userUrl": "{user_url}"
        },
        "resource": {
            "title": "{resource_title}",
            "id": "{resource_id}",
            "url": "{resource_url}",
            "addon": {
                "id": "{addon_id}",
                "title": "{addon_title}"
            },
            "bundle": {
                "id": "{bundle_id}",
                "title": "{bundle_title}"
            },
            "renewal": "{renewal}",
            "pricing": {
                "listPrice": "{list_price}",
                "finalPrice": "{final_price}"
            },
            "purchaseDate": "{purchase_date}"
        }
    },
    "lukittuData": {
        "productId": "YOUR_LUKITTU_PRODUCT_ID",
        "ipLimit": null,
        "hwidLimit": null,
        "expirationDays": null,
        "expirationStart": null
    }
}
6

Customize Webhook Data

Replace YOUR_BUILT_BY_BIT_SECRET with the integration secret from your Lukittu dashboard. Replace YOUR_LUKITTU_PRODUCT_ID with the product ID you copied earlier.
The fields ipLimit, hwidLimit, expirationDays, and expirationStart are optional configuration parameters. Leave them as null if you don’t need them, or set appropriate values based on your licensing requirements.
7

Save the Webhook

Click the Save button to create your purchase webhook.

​
Optional License Configuration

The following parameters can be customized in the webhook JSON:
KeyTypeDescription
ipLimitNumberMaximum number of IPs allowed.
hwidLimitNumberNumber of concurrent users allowed.
expirationDaysNumberNumber of days until the license expires.
expirationStartACTIVATION or CREATIONDetermines when expiration starts (default: CREATION). Applicable if expirationDays is used.

​
Setting Up License Placeholder

To enable automatic license delivery to your customers, you need to create a license placeholder:
1

Access BuiltByBit Placeholders

Go to the BuiltByBit placeholders page and click the Create placeholder button.
2

Configure Placeholder Settings

Enter a descriptive placeholder name (e.g., %%__LUKITTU_LICENSE_KEY__%%). Select External license key from the Type dropdown.
3

Set Placeholder URL

Enter the following URL: https://app.lukittu.com/api/v1/integrations/built-by-bit/placeholder?teamId=YOUR_TEAM_ID Replace YOUR_TEAM_ID with your Lukittu team’s ID.
4

Set Secret

Enter the BuiltByBit integration secret you created on your Lukittu dashboard.
5

Save the Placeholder

Click the Save button to create your license placeholder.

​
Verifying the Integration