Skip to navigation
FlashID Local APIProfiles

Create profile

View as Markdown

Create a browser profile.

Only system is required. Every other field is optional — omit it and a sensible default is used; omitted random / noise fingerprint fields (user_agent, webgl, canvas, audio_context, client_rects) are auto-generated.

Each fingerprint field is { "mode": ..., <value> } — for manual mode include the value(s); for random / noise mode you may omit the value — it’s generated automatically.

proxy (optional) — one of:

  • { "mode": "none" }
  • { "mode": "static", "proxy_uuid": "…" } — bind a saved proxy
  • { "mode": "rotating", "type": "residential", "region": "…", "state": "…", "city": "…", "session_sticky_ttl": 60 }

For a rotating residential proxy, session_sticky_ttl accepts 30, 60, 90, or 120 minutes. Omit it on create to use the default 30-minute sticky session. Request-based rotation is not available for Profiles.

Optional top-level sync_cookie, sync_password, and sync_bookmark accept numeric 0 or 1 only. Creation defaults are 1, 0, and 1 respectively. They control uploads on browser close; newer cloud data can still be downloaded at startup when a switch is 0.

Authentication

X-API-Keystring
API Key generated in the FlashID app.

Request

This endpoint expects an object.
systemobjectRequired
sync_passwordenumOptional

Password upload on close. 0 = off, 1 = on (default 0).

Allowed values:
sync_bookmarkenumOptional

Bookmark upload on close. 0 = off, 1 = on (default 1).

Allowed values:
profile_namestringOptional

Display name. Optional (default empty).

notestringOptional

Free-text note. Optional.

folder_uuidstringOptional

Folder to place the profile in. Optional (default “0” = root).

tag_uuidslist of stringsOptional

Tag UUIDs to assign. On create, omit for no tags. On update, omit to preserve current assignments; send [] to clear all assignments. Order is preserved.

cookiestringOptional

Cookies as a plaintext JSON string. Optional (omit for none).

launch_argumentslist of stringsOptional

Custom Chromium launch arguments. Optional (default empty). Each item is one argument.

proxyobjectOptional

Proxy config. Optional — omit the whole object for no proxy. When present, the shape depends on mode.

user_agentobjectOptional

User-Agent. Optional — omit to auto-generate (random).

webrtcobjectOptional

WebRTC. mode: off | real | auto | manual (default auto).

timezoneobjectOptional

Timezone. mode: auto | manual (default auto).

geo_locationobjectOptional

Geolocation. mode: auto | manual (default auto).

languageobjectOptional

Language. mode: auto | manual (default auto).

do_not_trackobjectOptional

Do Not Track. mode: off | on (default off). No value.

webgpuobjectOptional

WebGPU. mode: off | on (default on). No value.

webgl_infoobjectOptional

WebGL vendor/renderer. mode: real | random | manual (default random).

webglobjectOptional

WebGL image noise. mode: real | noise (default noise).

canvasobjectOptional

Canvas noise. mode: real | noise (default noise).

audio_contextobjectOptional

AudioContext noise. mode: real | noise (default noise).

client_rectsobjectOptional

ClientRects noise. mode: real | noise (default noise).

speech_voicesobjectOptional

Speech voices noise. mode: real | noise (default noise). No value.

screenobjectOptional

Screen resolution. mode: real | manual (default real).

fontsobjectOptional

Fonts. mode: auto | manual (default auto).

cpuobjectOptional

CPU cores (hardwareConcurrency). mode: real | random | manual (default random).

ramobjectOptional

Device memory in GB. mode: real | random | manual (default random).

media_devicesobjectOptional

Media devices. mode: real | auto | manual (default auto).

device_nameobjectOptional

Device name. mode: real | random | manual (default random).

mac_addressobjectOptional

MAC address. mode: real | random | manual (default random).

Response

Created
successboolean
codeinteger
dataobjectOptional