JSON parameter needs to be valid JSON
Body-ul scris în HTTP Request (Specify Body: Using JSON) nu e JSON valid după ce se calculează expresiile, de obicei pentru că o expresie text e pusă fără ghilimele sau ai ghilimele simple / virgulă la final. Pune expresiile text între ghilimele duble: "nume": "{{ $json.nume }}".
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În HTTP Request, la Send Body → Body Content Type JSON → Specify Body: Using JSON, scrii body-ul ca text JSON cu expresii. n8n calculează întâi expresiile, apoi verifică dacă rezultatul e JSON valid. Dacă nu, nodul se oprește cu JSON parameter needs to be valid JSON, înainte să trimită cererea.
Cea mai frecventă cauză: {"nume": {{ $json.nume }}}. Pentru Ana, rezultatul devine {"nume": Ana Popescu}, iar Ana Popescu fără ghilimele nu e o valoare JSON. Textele au nevoie de ghilimele ("{{ $json.nume }}"), numerele și booleenii nu. Alte cauze: ghilimele simple, chei fără ghilimele, virgulă după ultimul câmp, un text care conține ghilimele sau rânduri noi.
Pentru body-uri cu multe câmpuri sau cu texte libere, două variante mai sigure: Using Fields Below (perechi nume–valoare, fără JSON scris de mână) sau o singură expresie {{ JSON.stringify({ nume: $json.nume, total: $json.total }) }}.
De ce apare: cauzele frecvente
1Text fără ghilimele
{ "nume": {{ $json.nume }}, "total": {{ $json.total }} }{ "nume": "{{ $json.nume }}", "total": {{ $json.total }} }După calcul, numele trebuie să ajungă între ghilimele; numărul rămâne fără.
2Text care conține ghilimele
{ "nota": "{{ $json.nota }}" } // Livrare la "poartă"{{ JSON.stringify({ nota: $json.nota }) }}JSON.stringify scapă corect ghilimelele și rândurile noi din text.
3Virgulă după ultimul câmp
{ "nume": "Ana", "email": "ana@x.ro", }{ "nume": "Ana", "email": "ana@x.ro" }JSON nu permite virgulă după ultimul element.
Repară eroarea, direct în pagină
Nodul Lead în CRM se oprește cu „JSON parameter needs to be valid JSON”: în body, numele leadului e pus fără ghilimele. Repară JSON-ul ca să trimită nume (text) și email (text) și rulează: API-ul trebuie să creeze clientul Maria Enache.
Indiciu
Expresiile care dau text stau între ghilimele duble în JSON.
Reparația
În Lead în CRM, JSON:
{ "nume": "{{ $json.nume }}", "email": "{{ $json.email }}" }Execute workflow: API-ul răspunde 201 cu clientul creat.
De ce merge
După calculul expresiilor, body-ul vechi devenea { "nume": Maria Enache, ... }, care nu e JSON, deci n8n nu trimitea cererea. Cu ghilimele în jurul expresiilor text, body-ul devine { "nume": "Maria Enache", "email": "maria.enache@exemplu.ro" }, iar API-ul creează clientul și răspunde 201.
Alte forme ale mesajului
JSON parameter need to be an valid JSONThe value in the "JSON Body" field is not valid JSONUnexpected token A in JSON at position 10
Cum o eviți pe viitor
- Folosește Using Fields Below pentru body-uri simple.
- Pentru texte libere (mesaje, note, descrieri) construiește body-ul cu
JSON.stringify. - Verifică previzualizarea body-ului (rezultatul expresiilor) pentru câteva item-uri.
- Copiază un exemplu valid din documentație și înlocuiește doar valorile.
Întrebări frecvente
De ce merge pentru un client și pentru altul nu?
Valoarea diferă: un nume cu ghilimele, apostrof într-un text cu ghilimele simple sau o notă pe mai multe rânduri strică JSON-ul doar la acel item.
Ce înseamnă „Unexpected token A in JSON at position 10”?
Că la caracterul 10 al textului, parserul a găsit litera A acolo unde aștepta ghilimele sau o cifră: de obicei începutul unui text pus fără ghilimele.
Erori înrudite
The 'JSON Output' in item 0 contains invalid JSON Edit Fields este în modul JSON, iar textul din JSON Output nu e JSON valid: chei fără ghilimele, ghilimele simple, virgulă la final sau o expresie text pusă fără ghilimele. Scrie cheile și textele între ghilimele duble și pune expresiile de tip text în ghilimele: "nume": "{{ $json.nume }}". SyntaxError: "undefined" is not valid JSON JSON.parse a primit undefined, adică un câmp care nu există (nume greșit sau date lipsă), nu un text JSON. Verifică numele câmpului pe care îl parsezi și parsează doar dacă valoarea e text; dacă e deja obiect, nu mai ai nevoie de JSON.parse. Bad request - please check your parameters API-ul a răspuns 400 Bad Request: cererea e greșită ca formă, de obicei lipsește un parametru obligatoriu sau are o valoare invalidă. Citește detaliile erorii (serverul spune de obicei ce lipsește) și completează parametrul în Query Parameters sau în body. Învață n8n de la zero, cu exerciții la fiecare lecție
Curs Automatizări AI cu n8n: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
