v7

latestOpenAPI 3.0.4raw.githubusercontent.com2026-08-033267145.4 KB

Profile

Create a new profile based on a selected fingerprint. Supply the required configuration in the request body, then receive the newly created profile’s full details.

post/profiles/new

Request body

fingerprintIdstring nullable

The unique identifier of the fingerprint. This references the fingerprint which should be used to build the new profile. If not provided, a fingerprint will be automatically selected using the recommended fingerprint search defaults, see: https://developer.kameleo.io/tutorials/filtering-fingerprints/

namestring nullable

Sets a human-readable name for the profile, which is modifiable at any time.

folderIdstring uuid nullable

Id of the folder the profile should be created in. If null or empty (00000000-0000-0000-0000-000000000000) the profile will be created in root.

tagsstring[] nullable

Use tags to categorize profiles by labeling them accordingly.

canvas'intelligent' | 'noise' | 'block' | 'off'

Specifies how the canvas will be spoofed. Possible values: 'intelligent': Use intelligent canvas spoofing. This will result non-unique canvas fingerprints. 'noise': Add some noise to canvas generation. 'block': Completely block the 2D API. 'off': Turn off the spoofing, use the original settings.

webgl'noise' | 'block' | 'off'

Specifies how the WebGL will be spoofed. Possible values: 'noise': Add some noise to the WebGL generation 'block': Completely block the 3D API 'off': Turn off the spoofing, use the original settings

audio'off' | 'noise' | 'block'

Specifies how the audio will be spoofed. Possible values: 'noise': Add some noise to the Audio generation 'block': Completely block the Audio API 'off': Turn off the spoofing, use the original settings

fonts'automatic' | 'off'

Specifies how the fonts will be spoofed. Possible values: 'automatic': Spoof fonts based on the browser fingerpint. 'off': Don't spoof fonts, use the real fonts of your machine.

languagestring nullable

A language or a comma-separated list of languages for the profile. ISO 639-1 language and optionally ISO 3166-1 region code.

startPagestring uri nullable

This website will be opened in the browser when the profile launches.

passwordManager'enabled' | 'disabled'

Defines whether the browser can save login credentials. Possible values are: 'enabled': Credential saving is allowed. 'disabled': Credential saving is blocked.

extensionsstring[] nullable

A list of abolute paths from where the profile should load extensions or addons when starting the browser. For chrome and edge use CRX3 format extensions. For firefox use signed xpi format addons.

notesstring nullable

A free text including any notes written by the user.

storage'local' | 'cloud'

Example request

{
  "fingerprintId": "555b894595b5cd242ead1533218a5ee93dd7c7ebfbff4dccb80fdb112f6cda27",
  "folderId": "0036135c-6f62-429b-a9db-fd541aca96a7",
  "tags": [
    "facebook",
    "instagram"
  ],
  "webglMeta": {
    "extra": {
      "vendor": "Google Inc.",
      "renderer": "ANGLE (Intel(R) HD Graphics 630 Direct3D11 vs_5_0 ps_5_0)"
    }
  },
  "geolocation": {
    "extra": {
      "latitude": 59.43984,
      "longitude": 24.75815
    }
  },
  "proxy": {
    "extra": {
      "host": "127.0.0.1",
      "port": 9951,
      "id": "username",
      "secret": "password"
    }
  },
  "webRtc": {
    "extra": {
      "publicIp": "193.40.239.9"
    }
  },
  "language": "en-US,en",
  "startPage": "https://whoer.net/",
  "extensions": [
    "C:\\Users\\Windows 10\\Kameleo Extensions\\necessary-extension.crx"
  ],
  "notes": "I used this profile for affiliate marketing."
}

Response

OK.

idstring uuid required

A unique identifier of the profile

namestring required

Profile name property. The value obtained by file name for existing profiles. For new profiles the value is generated by a random name generator.

tagsstring[] required

Profile tags

createdAtstring date-time required

Date when the profile was created.

canvas'intelligent' | 'noise' | 'block' | 'off' required

webgl'noise' | 'block' | 'off' required

Specifies how the WebGL will be spoofed. Possible values: 'noise': Add some noise to the WebGL generation 'block': Completely block the 3D API 'off': Turn off the spoofing, use the original settings

audio'off' | 'noise' | 'block' required

fonts'automatic' | 'off' required

Specifies how the fonts will be spoofed. Possible values: 'automatic': Spoof fonts based on the browser fingerpint. 'off': Don't spoof fonts, use the real fonts of your machine.

languagestring required

A language or a comma-separated list of languages for the profile. ISO 639-1 language and optionally ISO 3166-1 region code.

startPagestring required

This website will be opened in the browser when the profile launches.

passwordManager'enabled' | 'disabled' required

Defines whether the browser can save login credentials. Possible values are: 'enabled': Credential saving is allowed. 'disabled': Credential saving is blocked.

extensionsstring[] required

A list of extensions or addons that will be loaded to the profile when the profile is started. For chrome and edge use CRX3 format extensions. For firefox use signed xpi format addons.

notesstring required

A free text including any notes written by the user.

storage'local' | 'cloud'

folderIdstring uuid nullable

A unique identifier of the containing folder or empty (00000000-0000-0000-0000-000000000000) if it is not in folder.

Example response

{
  "id": "a7cafbbe-6bc0-4575-8c6e-f1adf391f180",
  "name": "mystic-turtle",
  "tags": [
    "facebook",
    "instagram"
  ],
  "createdAt": "2020-05-02T03:10:32.2452701+10:00",
  "fingerprint": {
    "id": "555b894595b5cd242ead1533218a5ee93dd7c7ebfbff4dccb80fdb112f6cda27",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36",
    "device": {
      "type": "desktop",
      "name": "Samsung SM-A705FN"
    },
    "os": {
      "family": "windows",
      "version": "10.15.4",
      "platform": "64"
    },
    "browser": {
      "product": "chrome",
      "major": 81,
      "version": "81.0.4044"
    },
    "webglMeta": {
      "vendor": "Google Inc. (AMD)",
      "renderer": "ANGLE (AMD, AMD Radeon(TM) RX Vega 11 Graphics Direct3D11 vs_5_0 ps_5_0, D3D11)"
    },
    "resolution": "1920x1080",
    "fonts": [
      "Arial",
      "Tahoma"
    ]
  },
  "webglMeta": {
    "extra": {
      "vendor": "Google Inc.",
      "renderer": "ANGLE (Intel(R) HD Graphics 630 Direct3D11 vs_5_0 ps_5_0)"
    }
  },
  "geolocation": {
    "extra": {
      "latitude": 59.43984,
      "longitude": 24.75815
    }
  },
  "proxy": {
    "extra": {
      "host": "127.0.0.1",
      "port": 9951,
      "id": "username",
      "secret": "password"
    }
  },
  "webRtc": {
    "extra": {
      "publicIp": "193.40.239.9"
    }
  },
  "language": "en-US,en",
  "startPage": "https://whoer.net/",
  "extensions": [
    "C:\\Users\\Windows 10\\Kameleo Extensions\\necessary-extension.crx"
  ],
  "notes": "I used this profile for ad verification.",
  "folderId": "c7aafbbe-b6c0-5475-c66e-1fadf39180f1"
}