Creating Licenses

Creating a license

A license inherits all its properties from the default license template attached to its product. But you may want to override some properties like allowedActivations, subscriptionInterval, add some metadata etc. You can check out all the properties on the web API reference page.

You can also override the default license template by providing the licenseTemplateId at the time of creating a license.

By default, license keys are generated randomly, so the license type cannot be determined normally before the license activation. However, if you need to identify the license type beforehand, you can define a custom key while creating the license via the REST API by passing the key field in the request.

Example formats: NODE-LOCKED-XXXXXX-..., HOSTED-FLOATING-XXXXXX-..., NODE-LOCKED-OFFLINE-XXXXXX-..., etc.

This allows your application to infer the license type directly from the key before activation.

Following is a sample request which you will usually make to create a license:

Creating License

POST https://api.cryptlex.com/v3/licenses

Headers

Name	Type	Description
Authorization	string	Bearer Access Token

Request Body

Name	Type	Description
subscriptionInterval	string	The duration after which the license will expire.
allowedActivations	number	Allowed number of activations for the license.
userId	string	Unique identifier for the user.
productId	string	Unique identifier for the product.


{
  "key": "0A2035-E8A2A3-4D31B7-8FF9C6-81A6CA-539E54",
  "revoked": false,
  "suspended": false,
  "totalActivations": 0,
  "totalDeactivations": 0,
  "subscriptionInterval": "P1Y",
  "subscriptionStartTrigger": "creation",
  "fingerprintMatchingStrategy": "fuzzy",
  "allowedActivations": 1,
  "allowedDeactivations": 10,
  "type": "node-locked",
  "allowedFloatingClients": 0,
  "serverSyncGracePeriod": 2595000,
  "serverSyncInterval": 3600,
  "leaseDuration": 0,
  "expiresAt": "2026-05-05T08:49:17.9361143Z",
  "allowVmActivation": true,
  "userLocked": false,
  "productId": "63dfd63e-ed71-4f84-9236-02ee0ddb062c",
  "user": null,
  "allowedCountries": [],
  "disallowedCountries": [],
  "allowedIpAddresses": [],
  "disallowedIpAddresses": [],
  "metadata": [],
  "tags": [],
  "id": "23d9646c-34f5-4d37-adeb-f7f77b927bdb",
  "createdAt": "2025-05-06T08:49:17.9361143Z",
  "updatedAt": "2025-05-06T08:49:17.9361158Z"
}

Implementing License Models License Subscriptions

Last updated: 9/22/2025