Connector (n8n)

integrator2026-07-01

L’API connector inoltra un payload POP a un servizio esterno tramite un webhook n8n registrato. Attualmente supporta lo slug zoho (Zoho Invoice / Zoho Books).

Per il lato zoho, non serve costruire la logica da zero: esiste un pacchetto ufficiale, n8n-nodes-pop-zoho, che gira su una tua istanza n8n self-hosted, verifica la firma della richiesta e crea la fattura/nota di credito su Zoho — vedi guides/integrations/n8n-zoho per l’installazione. Se invece preferisci la sincronizzazione gestita direttamente da POP senza dover gestire un’istanza n8n tua, vedi api/zoho.

Endpoint

GET /wp-json/api/v2/connector/pubkey — chiave pubblica RSA per configurare il nodo n8n (nessuna auth)
POST /wp-json/api/v2/connector/{slug} — inoltra il payload (auth standard X-API-Key)

Cosa serve

integration.use deve essere n8n-zoho per il connector Zoho
integration.id — ID del webhook, dallo stesso registro dei webhook standard, con Connector type = n8n Connector — Zoho, abilitato

Errori lato POP

Codice	Status	Causa
`connector_not_found`	404	slug sconosciuto nell’URL
`missing_integration_id`	400	`integration.id` non fornito
`connector_webhook_not_found`	404	nessun webhook registrato per quell’`integration.id`
`connector_webhook_disabled`	422	webhook disabilitato nel pannello account
`connector_unreachable`	502	l’URL webhook n8n non ha risposto
`connector_invalid_response`	502	n8n ha risposto con contenuto non JSON

In environment: sandbox non vengono effettuate chiamate reali a Zoho e non si consuma quota.

Per generare fatture SdI/PEPPOL o validare partite IVA da n8n (pacchetto diverso, flusso diverso da questo connector), vedi guides/integrations/n8n.