API Request Tools
cURL POST JSON Example
Use when a POST endpoint expects a JSON request body. Keep the request small, compare cURL with fetch, and check the headers and body together before moving the setup into code or documentation.
API Request ToolsMinimal requestcURL exampleFetch snippet
Request check path
- Prepare the request
Start with the smallest JSON POST request sample that still reproduces the symptom.
- Check headers and body
Validate the body and headers for this JSON POST request together so one change does not hide the actual failure.
- Send it through the request tool
Move the method, URL, headers, and body into API Request Builder after you confirm that the JSON body is accepted before adding auth, retries, or optional fields.
JSON POST request checklist
Use this compact request before adding production-only headers, retries, or optional body fields.
| Check | Value |
|---|---|
Symptom | Use when a POST endpoint expects a JSON request body. |
cURL | curl -X POST https://api.example.com/items -H 'Content-Type: application/json' -d '{"name":"Ada"}' |
fetch | fetch('https://api.example.com/items', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ name: 'Ada' }) }) |
Headers to check | Content-Type, Authorization, Accept |
Copyable fixed snippet
curl -X POST https://api.example.com/items -H 'Content-Type: application/json' -d '{"name":"Ada"}'
fetch('https://api.example.com/items', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ name: 'Ada' }) })Mistakes to avoid
- Adding production headers before the basic body is accepted.
- Changing several headers and body fields during the same JSON POST request retry.
- Treating this JSON POST request failure as a parser problem before checking headers and body shape.