Connector (n8n)

integrator2026-07-01

The connector API forwards a POP payload to an external service through a registered n8n webhook. Currently supports the zoho slug (Zoho Invoice / Zoho Books).

For the zoho side, you don’t need to build the logic yourself: an official package, n8n-nodes-pop-zoho, runs on your own self-hosted n8n instance, verifies the request signature, and creates the invoice/credit note in Zoho — see guides/integrations/n8n-zoho for installation. If you’d rather have sync managed directly by POP without running your own n8n instance, see api/zoho.

Endpoint

GET /wp-json/api/v2/connector/pubkey — RSA public key to configure the n8n node (no auth)
POST /wp-json/api/v2/connector/{slug} — forwards the payload (standard X-API-Key auth)

What you need

integration.use must be n8n-zoho for the Zoho connector
integration.id — the webhook ID, from the same registry as standard webhooks, with Connector type = n8n Connector — Zoho, enabled

POP-side errors

Code	Status	Cause
`connector_not_found`	404	unknown slug in the URL
`missing_integration_id`	400	`integration.id` not provided
`connector_webhook_not_found`	404	no webhook registered for that `integration.id`
`connector_webhook_disabled`	422	webhook disabled in the account panel
`connector_unreachable`	502	the n8n webhook URL did not respond
`connector_invalid_response`	502	n8n responded with non-JSON content

In environment: sandbox no real calls to Zoho are made and no quota is consumed.

To generate SdI/PEPPOL invoices or validate VAT numbers from n8n (a different package, a different flow from this connector), see guides/integrations/n8n.