Create Task Overview
Code
POST https://solvercf.com/token/extension/createTask
The createTask endpoint submits a new CAPTCHA solving task to the SolverCF network. Because CAPTCHAs require browser execution, tasks are processed asynchronously — the endpoint immediately returns a taskId, which you then poll via Get Task Result.
Select Your CAPTCHA Type
For specific parameter tables, requirements, and full code examples (cURL, Python, Node.js, C#) for each CAPTCHA, please refer to the dedicated guide:
| CAPTCHA Type | Task Type (type) |
Typical Output | Documentation & Code Samples |
|---|---|---|---|
| Cloudflare Turnstile | TurnstileTask |
Token | Cloudflare Turnstile Guide → |
| Cloudflare Challenge | TurnstileTask |
cf_clearance cookie or Token |
Cloudflare Challenge Guide → |
| Google reCAPTCHA v3 | RecaptchaV3TaskProxyless / RecaptchaV3Task |
Token (score 0.7–0.9) | reCAPTCHA v3 Guide → |
| Google reCAPTCHA v3 Enterprise | RecaptchaV3EnterpriseTaskProxyless / RecaptchaV3EnterpriseTask |
Token (score 0.7–0.9) | reCAPTCHA v3 Enterprise Guide → |
| Pre-solved Token Pool | TurnstileTaskPool, RecaptchaV3TaskProxylessPool, etc. |
Instant token (< 100ms) | Token Pool Guide → |
Base Request Structure
All createTask requests share the same outer JSON envelope:
JSON
{
"clientKey": "YOUR_CLIENT_KEY",
"task": {
"type": "TurnstileTask",
"websiteUrl": "https://example.com",
"websiteKey": "0x4AAAAAAAB__YGWiObopXheP"
}
}
| Field | Type | Required | Description |
|---|---|---|---|
clientKey |
string | Yes | Your account API key. View it anytime in your Dashboard. |
task |
object | Yes | Payload containing specific parameters for the chosen CAPTCHA type. |
softId |
integer | No | Accepted for CapMonster compatibility (ignored by SolverCF). |
source |
string | No | Accepted for CapSolver compatibility (ignored by SolverCF). |
version |
string | No | Accepted for CapSolver compatibility (ignored by SolverCF). |
Response
Successful Creation (errorId: 0)
JSON
{
"errorId": 0,
"taskId": "7f8b9c2a-3d4e-5f6a-7b8c-9d0e1f2a3b4c",
"status": "created"
}
Save the taskId and pass it to Get Task Result to retrieve the solved token or cookie.
Error Response (errorId: 1)
If validation fails (for example, missing websiteUrl or websiteKey):
JSON
{
"errorId": 1,
"errorCode": "ERROR_KEY_DOES_NOT_EXIST",
"errorDescription": "clientKey is invalid or account not found",
"status": "failed"
}
See Errors & Status Codes for the complete list of error codes.