Overview The API cURL node executes cURL commands to make HTTP/HTTPS requests. It’s perfect for importing existing cURL commands from browser dev tools, Postman, or API documentation. The node parses cURL syntax and executes the request, storing the response in the workflow context.
Configuration Complete cURL command string. Supports variable interpolation. Example: curl -X POST https://api.example.com/data \ -H "Authorization: Bearer token" \ -H "Content-Type: application/json" \ -d '{"key": "value"}'
Request timeout in milliseconds.
contextKey
string
default: "apiResponse"
Context variable name to store the response.
If true, failed requests log warnings but don’t stop workflow execution.
Retry Configuration Enable automatic retry on failure.
Number of retry attempts.
Delay between retries in milliseconds.
Delay strategy: fixed or exponential
Supported cURL Options The node supports most common cURL options:
-X, --request - HTTP method (GET, POST, PUT, DELETE, etc.)-H, --header - Custom headers-d, --data - Request body--data-raw - Raw request body--data-binary - Binary data-F, --form - Form data (multipart)-u, --user - Basic authentication--compressed - Accept compressed responses-L, --location - Follow redirects-A, --user-agent - Custom user agent
Response Structure Same as API Request node:
{ "status" : 200 , "statusText" : "OK" , "headers" : { ... }, "body" : { ... }, "duration" : 523 , "timestamp" : "2024-01-15T10:30:00Z" }
Examples Basic Requests Simple GET
POST with JSON
PUT Request
{ "type" : "apiCurl" , "data" : { "curlCommand" : "curl https://api.example.com/users" , "contextKey" : "users" } }
With Authentication Bearer Token
API Key
Basic Auth
{ "type" : "apiCurl" , "data" : { "curlCommand" : "curl https://api.example.com/protected -H 'Authorization: Bearer ${data.token}'" } }
Chrome Copy as cURL
Firefox Copy as cURL
{ "type" : "apiCurl" , "data" : { "curlCommand" : "curl 'https://api.github.com/users/octocat' -H 'Accept: application/vnd.github+json' -H 'Authorization: Bearer ghp_xxxxxxxxxxxx' -H 'X-GitHub-Api-Version: 2022-11-28'" } }
Form Data
File Upload
Mixed Form
{ "type" : "apiCurl" , "data" : { "curlCommand" : "curl -X POST https://api.example.com/submit -F 'username=john' -F '[email protected] ' -F 'age=30'" } }
With Variables Dynamic URL
Dynamic Headers
Dynamic Body
{ "type" : "apiCurl" , "data" : { "curlCommand" : "curl https://api.example.com/users/${data.userId}" } }
Multiline cURL { "type" : "apiCurl" , "data" : { "curlCommand" : "curl -X POST https://api.example.com/graphql -H 'Content-Type: application/json' -H 'Authorization: Bearer token' -d '{ \" query \" : \" query { users { id name email } } \" }'" } }
With Retry { "type" : "apiCurl" , "data" : { "curlCommand" : "curl https://api.example.com/unstable-endpoint" , "retryEnabled" : true , "retryCount" : 3 , "retryDelay" : 2000 , "retryDelayStrategy" : "exponential" } }
Converting Browser Requests
Open DevTools (F12)
Go to Network tab
Perform the request
Right-click on the request
Select “Copy” > “Copy as cURL”
Paste into the curlCommand field
Open DevTools (F12)
Go to Network tab
Perform the request
Right-click on the request
Select “Copy” > “Copy as cURL”
Paste into the curlCommand field
From Postman
Open your request in Postman
Click “Code” button (code icon)
Select “cURL” from the dropdown
Copy the generated cURL command
Paste into the curlCommand field
cURL to API Request You can convert cURL commands to API Request nodes:
curl -X POST https://api.example.com/users \ -H "Content-Type: application/json" \ -H "Authorization: Bearer token" \ -d '{"name": "John"}'
{ "type" : "apiRequest" , "data" : { "url" : "https://api.example.com/users" , "method" : "POST" , "headers" : { "Content-Type" : "application/json" , "Authorization" : "Bearer token" }, "body" : "{ \" name \" : \" John \" }" , "bodyType" : "json" } }
Accessing Response Data In JavaScript Code
Chain Requests
const response = context . getData ( 'apiResponse' ); console . log ( `cURL request completed in ${ response . duration } ms` ); console . log ( `Status: ${ response . status } ` ); // Process response if ( response . status === 200 ) { context . setData ( 'requestSuccessful' , true ); }
Notes The cURL parser automatically handles quote escaping and multi-line commands. Just paste the command as-is from browser dev tools or Postman.
File paths in -F (form) options must exist on the machine running the workflow. The @ symbol indicates a file upload.
Variable interpolation works within the cURL command string, allowing dynamic URLs, headers, and body content.
Common Patterns API Testing [ { "type" : "apiCurl" , "data" : { "curlCommand" : "curl https://api.example.com/health" , "contextKey" : "healthCheck" } }, { "type" : "verify" , "data" : { "domain" : "api" , "verificationType" : "status" , "contextKey" : "healthCheck" , "expectedValue" : 200 } } ]
Quick Prototyping // Paste cURL from browser, iterate quickly { "type" : "apiCurl" , "data" : { "curlCommand" : "<paste from browser dev tools>" } }
