---
title: "Create a captcha-solving task"
method: POST
path: "/createTask"
tags: ["Tasks"]
---

# Create a captcha-solving task

`POST /createTask`

Submits a captcha for solving. The `task` object is a discriminated union keyed by
`task.type` (and, for `CustomTask`, additionally by `task.class`). On success returns a
`taskId` to be polled with `getTaskResult`.

## Request body

- CreateTaskRequest
  - `clientKey` string, required — Your account API key (from https://dash.capmonster.cloud). Authenticates the request.
  - `task` union, required — Captcha task descriptor. Discriminated by `type`. For `CustomTask`, the variant is further selected by `class`. Many types accept an optional `...Proxyless` alias for the `type` value.
    - ImageToTextTask — Recognise text on an image. Proxyless. **getTaskResult solution:** `textSolution` — see example `ready_ImageToTextTask`.
      - `type` 'ImageToTextTask', required
      - `body` string, required — Image file body in base64 (no line breaks).
      - `capMonsterModule` string — Name of the recognising module, e.g. "yandex".
      - `recognizingThreshold` integer — Recognition threshold (0–100).
      - `case` boolean — true if the captcha is case-sensitive.
      - `numeric` 0 | 1 — 1 if the captcha contains digits only.
      - `math` boolean — true if the captcha requires a mathematical operation.
    - RecaptchaV2Task — Optional proxy parameters. When omitted (for proxy-optional task types) CapMonster's built-in proxies are used. Some task types require a proxy (noted per schema). For IP-authorised proxies, whitelist `65.21.190.34`. Transparent and local proxies are not allowed.
      - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
      - `websiteKey` string, required — Site key of the captcha on the page.
      - `type` 'RecaptchaV2Task', required
      - `recaptchaDataSValue` string — One-time token from the data-s parameter, if present.
      - `isInvisible` boolean — true for invisible reCAPTCHA.
      - `cookies` string — Additional cookies, format: "name1=value1; name2=value2".
      - `userAgent` string — Browser User-Agent to emulate. Pass only a current Windows OS UA.
      - `proxyType` 'http' | 'https' | 'socks4' | 'socks5' — Proxy protocol.
      - `proxyAddress` string — Proxy IPv4/IPv6 address.
      - `proxyPort` integer — Proxy port.
      - `proxyLogin` string — Proxy username (for authorised proxies).
      - `proxyPassword` string — Proxy password (for authorised proxies).
    - RecaptchaV2EnterpriseTask — Optional proxy parameters. When omitted (for proxy-optional task types) CapMonster's built-in proxies are used. Some task types require a proxy (noted per schema). For IP-authorised proxies, whitelist `65.21.190.34`. Transparent and local proxies are not allowed.
      - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
      - `websiteKey` string, required — Site key of the captcha on the page.
      - `type` 'RecaptchaV2EnterpriseTask', required
      - `enterprisePayload` object — Extra parameters passed to grecaptcha.enterprise.render (e.g. `{ "s": "..." }`).
      - `apiDomain` string — Domain to load reCAPTCHA Enterprise from (e.g. www.google.com or www.recaptcha.net).
      - `pageAction` string — Value of the action parameter sent to Google.
      - `recaptchaDataSValue` string — One-time token from the data-s parameter, if present.
      - `cookies` string — Additional cookies, format: "name1=value1; name2=value2".
      - `userAgent` string — Browser User-Agent to emulate. Pass only a current Windows OS UA.
      - `proxyType` 'http' | 'https' | 'socks4' | 'socks5' — Proxy protocol.
      - `proxyAddress` string — Proxy IPv4/IPv6 address.
      - `proxyPort` integer — Proxy port.
      - `proxyLogin` string — Proxy username (for authorised proxies).
      - `proxyPassword` string — Proxy password (for authorised proxies).
    - RecaptchaV3Task — Base for tasks identified by a page URL and a site key.
      - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
      - `websiteKey` string, required — Site key of the captcha on the page.
      - `type` 'RecaptchaV3TaskProxyless', required
      - `minScore` number — Minimum acceptable score (0.1–0.9).
      - `pageAction` string — Widget action value.
      - `isEnterprise` boolean — Set true to solve v3 Enterprise via this task type.
    - RecaptchaV3EnterpriseTask — Base for tasks identified by a page URL and a site key.
      - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
      - `websiteKey` string, required — Site key of the captcha on the page.
      - `type` 'RecaptchaV3EnterpriseTask', required
      - `minScore` number — Minimum acceptable score (0.1–0.9).
      - `pageAction` string — Action parameter value passed to Google.
    - ComplexImageTask — Optional parameter documented for the task types that support browser emulation.
      - `type` 'ComplexImageTask', required
      - `class` 'recaptcha' | 'recognition', required — recaptcha (reCAPTCHA click) or recognition (module selected via metadata.Task).
      - `imageUrls` string[] — Links to images (4x4, 3x3 or 1x1 grid). Alternative to imagesBase64.
      - `imagesBase64` string[] — Base64 images. Alternative to imageUrls.
      - `exampleImageUrls` string[] — Optional links to example images.
      - `exampleImagesBase64` string[] — Optional base64 example images.
      - `metadata` object — Task metadata; which fields apply depends on `class` (see the task description).
        - `Grid` '4x4' | '3x3' | '1x1' — recaptcha: image grid size.
        - `Task` string — recaptcha: English task name; recognition: module name (e.g. "shein", "bls_3x3").
        - `TaskDefinition` string — recaptcha: technical task id (e.g. "/m/015qff").
        - `TaskArgument` string — recognition: target/instruction (e.g. a number to match or an icon name).
        - `PayloadType` string — recognition: payload kind (e.g. "Audio").
      - `websiteURL` string — Optional page URL containing the captcha. Also accepts websiteUrl.
      - `userAgent` string — Browser User-Agent to emulate. Pass only a current Windows OS UA.
    - FunCaptchaTask — Optional proxy parameters. When omitted (for proxy-optional task types) CapMonster's built-in proxies are used. Some task types require a proxy (noted per schema). For IP-authorised proxies, whitelist `65.21.190.34`. Transparent and local proxies are not allowed.
      - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
      - `type` 'FunCaptchaTask', required
      - `websitePublicKey` string, required — FunCaptcha public key (pk). The backend also accepts websiteKey.
      - `funcaptchaApiJSSubdomain` string — Arkose Labs subdomain (surl), without the https:// prefix. Only if non-default.
      - `data` string — Additional parameter; required if the site uses data[blob].
      - `cookies` string — Additional cookies, format: "name1=value1; name2=value2".
      - `userAgent` string — Browser User-Agent to emulate. Pass only a current Windows OS UA.
      - `proxyType` 'http' | 'https' | 'socks4' | 'socks5' — Proxy protocol.
      - `proxyAddress` string — Proxy IPv4/IPv6 address.
      - `proxyPort` integer — Proxy port.
      - `proxyLogin` string — Proxy username (for authorised proxies).
      - `proxyPassword` string — Proxy password (for authorised proxies).
    - GeeTestTask — Optional proxy parameters. When omitted (for proxy-optional task types) CapMonster's built-in proxies are used. Some task types require a proxy (noted per schema). For IP-authorised proxies, whitelist `65.21.190.34`. Transparent and local proxies are not allowed.
      - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
      - `type` 'GeeTestTask', required
      - `gt` string, required — GeeTest identifier key (static).
      - `challenge` string — Dynamic key — required for v3, obtained fresh per request.
      - `version` 3 | 4, required — GeeTest version.
      - `geetestApiServerSubdomain` string — GeeTest API server subdomain, if it differs from api.geetest.com.
      - `geetestGetLib` string — Path to the captcha script (send as a JSON string).
      - `initParameters` object — Additional v4 parameters (e.g. `{ "riskType": "slide" }`).
      - `userAgent` string — Browser User-Agent to emulate. Pass only a current Windows OS UA.
      - `proxyType` 'http' | 'https' | 'socks4' | 'socks5' — Proxy protocol.
      - `proxyAddress` string — Proxy IPv4/IPv6 address.
      - `proxyPort` integer — Proxy port.
      - `proxyLogin` string — Proxy username (for authorised proxies).
      - `proxyPassword` string — Proxy password (for authorised proxies).
    - TurnstileTask — Optional proxy parameters. When omitted (for proxy-optional task types) CapMonster's built-in proxies are used. Some task types require a proxy (noted per schema). For IP-authorised proxies, whitelist `65.21.190.34`. Transparent and local proxies are not allowed.
      - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
      - `websiteKey` string, required — Site key of the captcha on the page.
      - `type` 'TurnstileTask', required
      - `cloudflareTaskType` 'token' | 'cf_clearance' | 'wait_room' — Cloudflare variant selector (omit for the plain Turnstile widget).
      - `pageAction` string — Action field from the captcha callback (e.g. "managed", "non-interactive").
      - `action` string — Alternative action field accepted by the backend.
      - `data` string — Value from the cData parameter.
      - `pageData` string — Value from the chlPageData parameter (Challenge token mode).
      - `htmlPageBase64` string — Base64 of the challenge / waiting-room HTML page (cf_clearance / wait_room modes).
      - `apiJsUrl` string — Captcha script URL (optional).
      - `userAgent` string — Browser User-Agent to emulate. Pass only a current Windows OS UA.
      - `proxyType` 'http' | 'https' | 'socks4' | 'socks5' — Proxy protocol.
      - `proxyAddress` string — Proxy IPv4/IPv6 address.
      - `proxyPort` integer — Proxy port.
      - `proxyLogin` string — Proxy username (for authorised proxies).
      - `proxyPassword` string — Proxy password (for authorised proxies).
    - AmazonTask — Optional proxy parameters. When omitted (for proxy-optional task types) CapMonster's built-in proxies are used. Some task types require a proxy (noted per schema). For IP-authorised proxies, whitelist `65.21.190.34`. Transparent and local proxies are not allowed.
      - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
      - `type` 'AmazonTask', required
      - `websiteKey` string — From apiKey / window.gokuProps.key.
      - `captchaScript` string — Link to captcha.js / jsapi.js.
      - `challengeScript` string — Link to challenge.js.
      - `context` string — From the HTML page or window.gokuProps.context.
      - `iv` string — From the HTML page or window.gokuProps.iv.
      - `cookieSolution` boolean — When true, the solution is returned as cookies (e.g. aws-waf-token).
      - `userAgent` string — Browser User-Agent to emulate. Pass only a current Windows OS UA.
      - `proxyType` 'http' | 'https' | 'socks4' | 'socks5' — Proxy protocol.
      - `proxyAddress` string — Proxy IPv4/IPv6 address.
      - `proxyPort` integer — Proxy port.
      - `proxyLogin` string — Proxy username (for authorised proxies).
      - `proxyPassword` string — Proxy password (for authorised proxies).
    - BinanceTask — Optional proxy parameters. When omitted (for proxy-optional task types) CapMonster's built-in proxies are used. Some task types require a proxy (noted per schema). For IP-authorised proxies, whitelist `65.21.190.34`. Transparent and local proxies are not allowed.
      - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
      - `websiteKey` string, required — Site key of the captcha on the page.
      - `type` 'BinanceTask', required
      - `validateId` string, required — Dynamic key (validateId / securityId / securityCheckResponseValidateId).
      - `userAgent` string — Browser User-Agent to emulate. Pass only a current Windows OS UA.
      - `proxyType` 'http' | 'https' | 'socks4' | 'socks5' — Proxy protocol.
      - `proxyAddress` string — Proxy IPv4/IPv6 address.
      - `proxyPort` integer — Proxy port.
      - `proxyLogin` string — Proxy username (for authorised proxies).
      - `proxyPassword` string — Proxy password (for authorised proxies).
    - ProsopoTask — Optional proxy parameters. When omitted (for proxy-optional task types) CapMonster's built-in proxies are used. Some task types require a proxy (noted per schema). For IP-authorised proxies, whitelist `65.21.190.34`. Transparent and local proxies are not allowed.
      - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
      - `websiteKey` string, required — Site key of the captcha on the page.
      - `type` 'ProsopoTask', required
      - `proxyType` 'http' | 'https' | 'socks4' | 'socks5' — Proxy protocol.
      - `proxyAddress` string — Proxy IPv4/IPv6 address.
      - `proxyPort` integer — Proxy port.
      - `proxyLogin` string — Proxy username (for authorised proxies).
      - `proxyPassword` string — Proxy password (for authorised proxies).
    - YidunTask — Optional proxy parameters. When omitted (for proxy-optional task types) CapMonster's built-in proxies are used. Some task types require a proxy (noted per schema). For IP-authorised proxies, whitelist `65.21.190.34`. Transparent and local proxies are not allowed.
      - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
      - `websiteKey` string, required — Site key of the captcha on the page.
      - `type` 'YidunTask', required
      - `yidunApiServerSubdomain` string — Custom Yidun API server subdomain (enterprise).
      - `yidunGetLib` string — Full URL to the captcha JS file (enterprise).
      - `challenge` string — Unique captcha identifier (enterprise).
      - `hcg` string — Captcha hash for the request (enterprise).
      - `hct` integer — Numeric timestamp for validation (enterprise).
      - `userAgent` string — Browser User-Agent to emulate. Pass only a current Windows OS UA.
      - `proxyType` 'http' | 'https' | 'socks4' | 'socks5' — Proxy protocol.
      - `proxyAddress` string — Proxy IPv4/IPv6 address.
      - `proxyPort` integer — Proxy port.
      - `proxyLogin` string — Proxy username (for authorised proxies).
      - `proxyPassword` string — Proxy password (for authorised proxies).
    - MTCaptchaTask — Optional proxy parameters. When omitted (for proxy-optional task types) CapMonster's built-in proxies are used. Some task types require a proxy (noted per schema). For IP-authorised proxies, whitelist `65.21.190.34`. Transparent and local proxies are not allowed.
      - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
      - `websiteKey` string, required — Site key of the captcha on the page.
      - `type` 'MTCaptchaTask', required
      - `pageAction` string — Action parameter (passed as `act`).
      - `isInvisible` boolean — true for invisible MTCaptcha.
      - `userAgent` string — Browser User-Agent to emulate. Pass only a current Windows OS UA.
      - `proxyType` 'http' | 'https' | 'socks4' | 'socks5' — Proxy protocol.
      - `proxyAddress` string — Proxy IPv4/IPv6 address.
      - `proxyPort` integer — Proxy port.
      - `proxyLogin` string — Proxy username (for authorised proxies).
      - `proxyPassword` string — Proxy password (for authorised proxies).
    - union — Generic "custom" captcha tasks, discriminated by `class`. Covers DataDome, Imperva, Basilisk, TenDI, Altcha, TSPD, HUNT, Alibaba and Friendly captcha.
      - DataDomeTask — Optional proxy parameters. When omitted (for proxy-optional task types) CapMonster's built-in proxies are used. Some task types require a proxy (noted per schema). For IP-authorised proxies, whitelist `65.21.190.34`. Transparent and local proxies are not allowed.
        - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
        - `type` 'CustomTask', required
        - `class` 'DataDome', required
        - `metadata` object, required
          - `captchaUrl` string, required — Link to the captcha (https://geo.captcha-delivery.com/captcha/?initialCid=...).
          - `datadomeCookie` string, required — DataDome cookie value.
          - `datadomeVersion` 'new' — Set "new" to support both i.js and c.js scripts.
        - `userAgent` string — Browser User-Agent to emulate. Pass only a current Windows OS UA.
        - `proxyType` 'http' | 'https' | 'socks4' | 'socks5' — Proxy protocol.
        - `proxyAddress` string — Proxy IPv4/IPv6 address.
        - `proxyPort` integer — Proxy port.
        - `proxyLogin` string — Proxy username (for authorised proxies).
        - `proxyPassword` string — Proxy password (for authorised proxies).
      - ImpervaTask — Optional proxy parameters. When omitted (for proxy-optional task types) CapMonster's built-in proxies are used. Some task types require a proxy (noted per schema). For IP-authorised proxies, whitelist `65.21.190.34`. Transparent and local proxies are not allowed.
        - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
        - `type` 'CustomTask', required
        - `class` 'Imperva', required
        - `metadata` object, required
          - `incapsulaScriptUrl` string, required — Name of the Incapsula JS file (e.g. "_Incapsula_Resource?SWJIYLWA=...").
          - `incapsulaCookies` string, required — Incapsula cookies (visid_incap_ and incap_ses_).
          - `reese84UrlEndpoint` string — Endpoint name where the reese84 fingerprint is sent.
        - `userAgent` string — Browser User-Agent to emulate. Pass only a current Windows OS UA.
        - `proxyType` 'http' | 'https' | 'socks4' | 'socks5' — Proxy protocol.
        - `proxyAddress` string — Proxy IPv4/IPv6 address.
        - `proxyPort` integer — Proxy port.
        - `proxyLogin` string — Proxy username (for authorised proxies).
        - `proxyPassword` string — Proxy password (for authorised proxies).
      - BasiliskTask — Optional proxy parameters. When omitted (for proxy-optional task types) CapMonster's built-in proxies are used. Some task types require a proxy (noted per schema). For IP-authorised proxies, whitelist `65.21.190.34`. Transparent and local proxies are not allowed.
        - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
        - `websiteKey` string, required — Site key of the captcha on the page.
        - `type` 'CustomTask', required
        - `class` 'Basilisk', required
        - `userAgent` string — Browser User-Agent to emulate. Pass only a current Windows OS UA.
        - `proxyType` 'http' | 'https' | 'socks4' | 'socks5' — Proxy protocol.
        - `proxyAddress` string — Proxy IPv4/IPv6 address.
        - `proxyPort` integer — Proxy port.
        - `proxyLogin` string — Proxy username (for authorised proxies).
        - `proxyPassword` string — Proxy password (for authorised proxies).
      - TenDITask — Optional proxy parameters. When omitted (for proxy-optional task types) CapMonster's built-in proxies are used. Some task types require a proxy (noted per schema). For IP-authorised proxies, whitelist `65.21.190.34`. Transparent and local proxies are not allowed.
        - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
        - `websiteKey` string, required — Site key of the captcha on the page.
        - `type` 'CustomTask', required
        - `class` 'TenDI', required
        - `metadata` object
          - `captchaUrl` string — Link to the captcha script (usually ending with TCaptcha.js / TCaptcha-global.js).
        - `userAgent` string — Browser User-Agent to emulate. Pass only a current Windows OS UA.
        - `proxyType` 'http' | 'https' | 'socks4' | 'socks5' — Proxy protocol.
        - `proxyAddress` string — Proxy IPv4/IPv6 address.
        - `proxyPort` integer — Proxy port.
        - `proxyLogin` string — Proxy username (for authorised proxies).
        - `proxyPassword` string — Proxy password (for authorised proxies).
      - AltchaTask — Optional proxy parameters. When omitted (for proxy-optional task types) CapMonster's built-in proxies are used. Some task types require a proxy (noted per schema). For IP-authorised proxies, whitelist `65.21.190.34`. Transparent and local proxies are not allowed.
        - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
        - `type` 'CustomTask', required
        - `class` 'altcha', required
        - `websiteKey` string — Empty string allowed for this task.
        - `metadata` object, required
          - `challenge` string, required — Unique task identifier from the website.
          - `iterations` string, required — Number of iterations (maxnumber).
          - `salt` string, required — Full salt including all embedded parameters.
          - `signature` string, required — Digital signature of the request.
        - `userAgent` string — Browser User-Agent to emulate. Pass only a current Windows OS UA.
        - `proxyType` 'http' | 'https' | 'socks4' | 'socks5' — Proxy protocol.
        - `proxyAddress` string — Proxy IPv4/IPv6 address.
        - `proxyPort` integer — Proxy port.
        - `proxyLogin` string — Proxy username (for authorised proxies).
        - `proxyPassword` string — Proxy password (for authorised proxies).
      - TspdTask — Optional proxy parameters. When omitted (for proxy-optional task types) CapMonster's built-in proxies are used. Some task types require a proxy (noted per schema). For IP-authorised proxies, whitelist `65.21.190.34`. Transparent and local proxies are not allowed.
        - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
        - `type` 'CustomTask', required
        - `class` 'tspd', required
        - `metadata` object, required
          - `tspdCookie` string, required — Cookies from the TSPD challenge page.
          - `htmlPageBase64` string, required — Entire TSPD page encoded in base64.
        - `userAgent` string — Browser User-Agent to emulate. Pass only a current Windows OS UA.
        - `proxyType` 'http' | 'https' | 'socks4' | 'socks5' — Proxy protocol.
        - `proxyAddress` string — Proxy IPv4/IPv6 address.
        - `proxyPort` integer — Proxy port.
        - `proxyLogin` string — Proxy username (for authorised proxies).
        - `proxyPassword` string — Proxy password (for authorised proxies).
      - HuntTask — Optional proxy parameters. When omitted (for proxy-optional task types) CapMonster's built-in proxies are used. Some task types require a proxy (noted per schema). For IP-authorised proxies, whitelist `65.21.190.34`. Transparent and local proxies are not allowed.
        - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
        - `type` 'CustomTask', required
        - `class` 'HUNT', required
        - `metadata` object, required
          - `apiGetLib` string, required — Full link to the api.js file.
          - `data` string — meta.token from the website — include only for solving mode; omit for fingerprint generation.
        - `userAgent` string — Browser User-Agent to emulate. Pass only a current Windows OS UA.
        - `proxyType` 'http' | 'https' | 'socks4' | 'socks5' — Proxy protocol.
        - `proxyAddress` string — Proxy IPv4/IPv6 address.
        - `proxyPort` integer — Proxy port.
        - `proxyLogin` string — Proxy username (for authorised proxies).
        - `proxyPassword` string — Proxy password (for authorised proxies).
      - AlibabaTask — Optional proxy parameters. When omitted (for proxy-optional task types) CapMonster's built-in proxies are used. Some task types require a proxy (noted per schema). For IP-authorised proxies, whitelist `65.21.190.34`. Transparent and local proxies are not allowed.
        - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
        - `type` 'CustomTask', required
        - `class` 'alibaba', required
        - `metadata` object, required
          - `sceneId` string, required — Captcha scenario identifier (e.g. "1ww7426c4").
          - `prefix` string, required — Initialisation parameter (subdomain from captcha URL).
          - `userId` string
          - `userUserId` string
          - `verifyType` string
          - `region` string
          - `UserCertifyId` string
          - `apiGetLib` string — Link to the captcha JS library.
        - `userAgent` string — Browser User-Agent to emulate. Pass only a current Windows OS UA.
        - `proxyType` 'http' | 'https' | 'socks4' | 'socks5' — Proxy protocol.
        - `proxyAddress` string — Proxy IPv4/IPv6 address.
        - `proxyPort` integer — Proxy port.
        - `proxyLogin` string — Proxy username (for authorised proxies).
        - `proxyPassword` string — Proxy password (for authorised proxies).
      - FriendlyTask — Optional proxy parameters. When omitted (for proxy-optional task types) CapMonster's built-in proxies are used. Some task types require a proxy (noted per schema). For IP-authorised proxies, whitelist `65.21.190.34`. Transparent and local proxies are not allowed.
        - `websiteURL` string, required — URL of the page with the captcha. Also accepts websiteUrl.
        - `websiteKey` string, required — Site key of the captcha on the page.
        - `type` 'CustomTask', required
        - `class` 'friendly', required
        - `metadata` object, required
          - `apiGetLib` string, required — URL of the JS file (version-dependent — widget.module.min.js for V1, site.min.js for V2).
        - `userAgent` string — Browser User-Agent to emulate. Pass only a current Windows OS UA.
        - `proxyType` 'http' | 'https' | 'socks4' | 'socks5' — Proxy protocol.
        - `proxyAddress` string — Proxy IPv4/IPv6 address.
        - `proxyPort` integer — Proxy port.
        - `proxyLogin` string — Proxy username (for authorised proxies).
        - `proxyPassword` string — Proxy password (for authorised proxies).
  - `softId` integer — Optional developer/software identifier.
  - `callbackUrl` string, uri — Optional absolute URL. When set, the task result is POSTed to this address once solved, in addition to being available via `getTaskResult`.

## Response `200`

Task accepted, or a business error encoded in the body (`errorId` non-zero). Auth and
balance failures use `403` / `402` (below); other errors come back here with `errorId: 1`.

- CreateTaskResponse
  - `errorId` integer, required — `0` = success, non-zero = error.
  - `errorCode` 'ERROR_KEY_DOES_NOT_EXIST' | 'ERROR_ZERO_BALANCE' | 'ERROR_TOO_BIG_CAPTCHA_FILESIZE' | 'ERROR_ZERO_CAPTCHA_FILESIZE' | 'ERROR_NO_SUCH_CAPCHA_ID' | 'WRONG_CAPTCHA_ID' | 'ERROR_CAPTCHA_UNSOLVABLE' | 'CAPTCHA_NOT_READY' | 'ERROR_IP_NOT_ALLOWED' | 'ERROR_IP_BANNED' | 'ERROR_NO_SUCH_METHOD' | 'ERROR_TOO_MUCH_REQUESTS' | 'ERROR_DOMAIN_NOT_ALLOWED' | 'ERROR_TOKEN_EXPIRED' | 'ERROR_NO_SLOT_AVAILABLE' | 'ERROR_RECAPTCHA_INVALID_SITEKEY' | 'ERROR_RECAPTCHA_INVALID_DOMAIN' | 'ERROR_RECAPTCHA_TIMEOUT' | 'ERROR_IP_BLOCKED' | 'ERROR_PROXY_CONNECT_REFUSED' | 'ERROR_PROXY_BANNED' | 'ERROR_PROXY_MISSING' | 'ERROR_PROXY_NOT_AUTHORISED' | 'ERROR_PROXY_READ_TIMEOUT' | 'ERROR_TASK_NOT_SUPPORTED' | 'ERROR_TASK_ABSENT' | 'ERROR_WRONG_USERAGENT' — Machine-readable error code returned when `errorId` is non-zero.
  - `errorDescription` string, nullable
  - `taskId` integer — Identifier of the created task (use with `getTaskResult`). `0` on error.

## Other responses

- `402` — Zero balance (`ERROR_ZERO_BALANCE`).
- `403` — Invalid / unknown API key (`ERROR_KEY_DOES_NOT_EXIST`).

---

[API](https://skmtc.dev/capmonster/apis/capmonster-cloud-api-createtask-gettaskresult-getbalance.md) · [All operations](https://skmtc.dev/capmonster/apis/capmonster-cloud-api-createtask-gettaskresult-getbalance/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/capmonster/capmonster-cloud-api-createtask-gettaskresult-getbalance/revisions/d742f6de22b5/schema)