OpenAPI Connector

action_openapi · action · Utility · Available · v1.0.0

Description

Universal connector: call ANY REST API described by an OpenAPI 3.0 (Swagger) spec. Paste the provider spec (Stripe, Slack, Notion, GitHub, your own ERP…), pick the operation, and one node covers thousands of endpoints — no dedicated node needed per service.

⚙️ Configuration parameters

Fields shown in the editor when configuring the node. Generated directly from the NodeDefconfigFields.

Field	Type	Required	Default	Description
`specJson` Spec OpenAPI 3.0 (JSON)	`JSON object/array`	yes	—	La spec del provider in JSON. Da servers[] viene preso il base URL; da paths le operations disponibili.
`operationId` Operation ID	`string`	yes	— getUser	L'operationId dell'endpoint da chiamare (come nella spec). Se manca nella spec, usa "METHOD /path" (es. "GET /users").
`baseUrl` Base URL (override)	`string`	no	— https://api.example.com/v1	Sovrascrive il server della spec. Vuoto = primo servers[].url della spec.
`paramsJson` Parametri (JSON)	`JSON object/array`	no	— { "id": "42", "fields": "name,email" }	Oggetto chiave→valore per i parametri path/query/header dell'operation. I path param obbligatori mancanti danno errore.
`bodyJson` Request body (JSON)	`JSON object/array`	no	—	Body inviato per le operations che lo accettano (POST/PUT/PATCH con requestBody). Content-Type application/json automatico.
`authHeader` Header di autenticazione	`string`	no	— Authorization	Nome dell'header auth (es. Authorization, X-API-Key). Vuoto = nessuna auth.
`authValue` Valore autenticazione	`string (encrypted)`	no	— Bearer sk_live_…	Valore dell'header auth. Tenuto come secret.
`timeoutMs` Timeout (ms)	`number`	no	`30000`	Timeout della richiesta in millisecondi. Default 30s.

⬆️ Node output

Fields available to downstream nodes via $node.<alias>.json.<field>:

status
operationId
data

💡 Configuration example

JSON snippet of the node as it appears in the workflow. Values are derived fromdefaultValue and from required parameters.

{
  "id": "node-action_openapi-1",
  "defId": "action_openapi",
  "label": "OpenAPI Connector",
  "config": {
    "specJson": "<specJson>",
    "operationId": "getUser",
    "timeoutMs": 30000
  }
}

🔗 Related nodes in the same category

Ready to use OpenAPI Connector?

Available now on all FlowForge plans. Try it free without a credit card.

Start free Browse all nodes