---
title: "Create a profile"
method: POST
path: "/v1/profiles"
tags: ["Profiles"]
---

# Create a profile

`POST /v1/profiles`

Create a new profile

## Response `201`

Default Response

- Profile
  - `createdAt` string, date-time, required — The date and time when the profile was created
  - `credentialsConfig` unknown, required
  - `dimensions` object, nullable, required — The dimensions associated with the profile
    - `height` number, required
    - `width` number, required
  - `extensionIds` string[], nullable, required — The extension IDs associated with the profile
  - `fingerprint` object, nullable, required — The fingerprint associated with the profile
    - `fingerprint` object, required
      - `audioCodecs` object, required
      - `battery` object, required
        - `charging` boolean, nullable, required
        - `chargingTime` number, nullable, required
        - `dischargingTime` number, nullable, required
        - `level` number, nullable, required
      - `fonts` string[], required
      - `mockWebRTC` boolean, nullable, required
      - `multimediaDevices` object, required
        - `micros` object[], required
          - `deviceId` string, nullable, required
          - `groupId` string, nullable, required
          - `kind` string, nullable, required
          - `label` string, nullable, required
        - `speakers` object[], required
          - `deviceId` string, nullable, required
          - `groupId` string, nullable, required
          - `kind` string, nullable, required
          - `label` string, nullable, required
        - `webcams` object[], required
          - `deviceId` string, nullable, required
          - `groupId` string, nullable, required
          - `kind` string, nullable, required
          - `label` string, nullable, required
      - `navigator` object, required
        - `appCodeName` string, nullable, required
        - `appName` string, nullable, required
        - `appVersion` string, nullable, required
        - `deviceMemory` number, nullable, required
        - `doNotTrack` string, nullable
        - `extraProperties` object, required
          - `globalPrivacyControl` boolean, nullable, required
          - `installedApps` string[], required
          - `pdfViewerEnabled` boolean, nullable, required
          - `vendorFlavors` string[], required
        - `hardwareConcurrency` number, nullable, required
        - `language` string, nullable, required
        - `languages` string[], required
        - `maxTouchPoints` number, nullable, required
        - `oscpu` string, nullable, required
        - `platform` string, nullable, required
        - `product` string, nullable, required
        - `productSub` string, nullable, required
        - `userAgent` string, nullable, required
        - `userAgentData` object, required
          - `brands` object[], required
            - `brand` string, nullable, required
            - `version` string, nullable, required
          - `mobile` boolean, nullable, required
          - `platform` string, nullable, required
        - `vendor` string, nullable, required
        - `vendorSub` string, nullable, required
        - `webdriver` boolean, nullable, required
      - `pluginsData` object, required
        - `mimeTypes` string[], required
        - `plugins` object[], required
          - `description` string, nullable, required
          - `filename` string, nullable, required
          - `mimeTypes` object[], required
            - `description` string, nullable, required
            - `enabledPlugin` string, nullable, required
            - `suffixes` string, nullable, required
            - `type` string, nullable, required
          - `name` string, nullable, required
      - `screen` object, required
        - `availHeight` number, nullable, required
        - `availLeft` number, nullable, required
        - `availTop` number, nullable, required
        - `availWidth` number, nullable, required
        - `clientHeight` number, nullable, required
        - `clientWidth` number, nullable, required
        - `colorDepth` number, nullable, required
        - `devicePixelRatio` number, nullable, required
        - `hasHDR` boolean, nullable, required
        - `height` number, nullable, required
        - `innerHeight` number, nullable, required
        - `innerWidth` number, nullable, required
        - `outerHeight` number, nullable, required
        - `outerWidth` number, nullable, required
        - `pageXOffset` number, nullable, required
        - `pageYOffset` number, nullable, required
        - `pixelDepth` number, nullable, required
        - `screenX` number, nullable, required
        - `width` number, nullable, required
      - `slim` boolean, nullable, required
      - `videoCard` object, required
        - `renderer` string, nullable, required
        - `vendor` string, nullable, required
      - `videoCodecs` object, required
    - `headers` object, required
      - `accept` string, nullable
      - `accept-encoding` string, nullable
      - `accept-language` string, nullable
      - `dnt` string, nullable
      - `sec-ch-ua` string, nullable
      - `sec-ch-ua-mobile` string, nullable
      - `sec-ch-ua-platform` string, nullable
      - `sec-fetch-dest` string, nullable
      - `sec-fetch-mode` string, nullable
      - `sec-fetch-site` string, nullable
      - `sec-fetch-user` string, nullable
      - `upgrade-insecure-requests` string, nullable
      - `user-agent` string, nullable, required
  - `id` string, uuid, required — The unique identifier for the profile
  - `projectId` string, uuid, nullable, required — The project ID associated with the profile
  - `sourceSessionId` string, uuid, nullable, required — The last session ID associated with the profile
  - `status` 'UPLOADING' | 'READY' | 'FAILED', required — The status of the profile
  - `updatedAt` string, date-time, required — The date and time when the profile was last updated
  - `useProxyConfig` unknown, required
  - `userAgent` string, nullable, required — The user agent associated with the profile

## Other responses

- `400` — An error response from the API
- `404` — An error response from the API
- `413` — An error response from the API
- `500` — An error response from the API

---

[API](https://skmtc.net/steel-dev/apis/steel-api.md) · [All operations](https://skmtc.net/steel-dev/apis/steel-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/steel-dev/steel-api/revisions/2248d956188a/schema)