Create an activation

Creates a new activation.

POST/v3/activations

Request Body Schema

Property	Type	Description	Constraints
os*	string	Name of the operating system.	enum: [windows, linux, macos, android, ios]
osVersion	string	Version of the operating system.	min: 0, max: 256
fingerprint*	string	Fingerprint of the machine.	min: 64, max: 1024
vmName	string	Name of the virtual machine.	min: 0, max: 256
container	boolean	Whether app is run inside a container.
hostname*	string	Name of the host machine.	min: 1, max: 1024
userHash*	string	Hash of the machine user name.	min: 1, max: 256
productId*	string	Unique identifier for the product.	min: 1, max: 256
accountId*	string	Unique identifier for the account.	min: 0, max: 256
releaseVersion	string	The release version of the app. Only following three formats are allowed x.x, x.x.x, x.x.x.x.	min: 0, max: 256
releaseChannel	string	The release channel of the app.	min: 0, max: 256
releasePlatform	string	The release platform of the app.	min: 0, max: 256
releasePublishedAt	string	This release published date (UTC) of the app.	format: date-time
key*	string	License key to activate the license.	min: 1, max: 256
userId	string	Unique identifier for the user.	min: 0, max: 256
leaseDuration	integer	Lease duration of the activation in case of hosted floating license. Set to 0 or -1 for unlimited.	min: -1, max: 9223372036854776000, format: int64
metadata	array	List of metdata key/value pairs.	items: object
key*	string	Name of the key.	min: 1, max: 256
value*	string	Value of the key.	min: 0, max: 4096
meterAttributes	array	List of meter attributes.	items: object
name*	string	Name of the attribute.	min: 1, max: 256
usesIncrement*	integer	Positive or negative increment to update the uses of the attribute.	format: int64

Request Example

{
  "os": "windows",
  "osVersion": "string",
  "fingerprint": "stringstringstringstringstringstringstringstringstringstringstri",
  "vmName": "string",
  "container": true,
  "hostname": "string",
  "userHash": "string",
  "productId": "string",
  "accountId": "string",
  "releaseVersion": "string",
  "releaseChannel": "string",
  "releasePlatform": "string",
  "releasePublishedAt": "2019-08-24T14:15:22Z",
  "key": "string",
  "userId": "string",
  "leaseDuration": -1,
  "metadata": [
    {
      "key": "string",
      "value": "string"
    }
  ],
  "meterAttributes": [
    {
      "name": "string",
      "usesIncrement": 0
    }
  ]
}

Triggers webhook: activation.created

POST <your-webhook-url>
{
  "event": "activation.created",
  "data": {
    "id": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "os": "windows",
    "osVersion": "string",
    "hostname": "string",
    "location": {
      "ipAddress": "string",
      "countryCode": "string",
      "countryName": "string",
      "regionCode": "string",
      "regionName": "string",
      "city": "string",
      "zipCode": "string",
      "timeZone": "string",
      "latitude": 0.1,
      "longitude": 0.1
    },
    "vmName": "string",
    "container": true,
    "appVersion": "string",
    "releaseVersion": "string",
    "releaseChannel": "string",
    "releasePlatform": "string",
    "offline": true,
    "productId": "string",
    "expiresAt": "2019-08-24T14:15:22Z",
    "licenseId": "string",
    "lastSyncedAt": "2019-08-24T14:15:22Z",
    "meterAttributes": [
      {
        "name": "string",
        "uses": 0
      }
    ],
    "leaseExpiresAt": "2019-08-24T14:15:22Z",
    "organization": {
      "id": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "name": "string",
      "email": "string",
      "description": "string",
      "allowedUsers": 0,
      "address": {
        "addressLine1": "string",
        "addressLine2": "string",
        "city": "string",
        "state": "string",
        "country": "string",
        "postalCode": "string"
      },
      "resellerId": "string",
      "reseller": {
        "id": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "name": "string",
        "email": "string",
        "description": "string",
        "allowedUsers": 0,
        "allowedOrganizations": 0
      }
    },
    "userId": "string",
    "user": {
      "id": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "name": "string",
      "firstName": "string",
      "lastName": "string",
      "email": "string",
      "role": "string",
      "twoFactorEnabled": true,
      "googleSsoEnabled": true,
      "lastLoginAt": "2019-08-24T14:15:22Z",
      "company": "string",
      "allowCustomerPortalAccess": true,
      "roles": [
        "string"
      ],
      "lastSeenAt": "2019-08-24T14:15:22Z",
      "organizationId": "string",
      "organization": {
        "id": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "name": "string",
        "email": "string",
        "description": "string",
        "allowedUsers": 0,
        "address": {
          "addressLine1": "string",
          "addressLine2": "string",
          "city": "string",
          "state": "string",
          "country": "string",
          "postalCode": "string"
        },
        "resellerId": "string",
        "reseller": {
          "id": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "name": "string",
          "email": "string",
          "description": "string",
          "allowedUsers": 0,
          "allowedOrganizations": 0
        }
      },
      "resellerId": "string",
      "reseller": {
        "id": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "name": "string",
        "email": "string",
        "description": "string",
        "allowedUsers": 0,
        "allowedOrganizations": 0
      },
      "metadata": [
        {
          "id": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "key": "string",
          "value": "string",
          "viewPermissions": [
            "activation"
          ],
          "visible": true
        }
      ],
      "tags": [
        "string"
      ],
      "emailPreference": {
        "metrics": true
      }
    },
    "metadata": [
      {
        "id": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "key": "string",
        "value": "string"
      }
    ]
  },
  "triggeredAt": "string"
}

Responses

200

400

409

429

500

200 OK

{
  "activationToken": "string"
}