Description

n8n-nodes-ovh

 

 ![Active Status] ![License] ![n8n Community] ![OVH API]

Comprehensive OVH integration for n8n workflow automation
🚀 Production Ready – 8 active nodes with 450+ operations
Developed by Ascenzia

🌟 Features

This n8n community node provides comprehensive integration with OVH’s suite of cloud services, enabling powerful automation workflows for European cloud infrastructure.

🔧 Active Nodes (13)

| Service | Description | Key Operations |
|———|————-|—————-|
| AI | Machine Learning & AI services | Applications, Training Jobs, Notebooks |
| Account | Account & billing management | Profile, Bills (incl. PDF download), Contacts, API Keys |
| Container Registry | Managed container registry | Registries, Users, Credentials |
| Database | Managed database services | Clusters, Users, Databases |
| Data Processing | Analytics and processing | Jobs, Capabilities |
| Dedicated Server | Bare metal infrastructure | Server management, OS installation, Networking |
| Domain | Domain & DNS management | Domains, DNS Records (CRUD), Nameservers |
| Hosted Private Cloud | VMware Private Cloud | Datacenters, Hosts, Storage, Networks |
| Kubernetes | Managed Kubernetes service | Clusters, Node Pools, IP Restrictions |
| Order (Beta) | Order & cart management | Carts, Items, Coupons, Checkout, Domain availability |
| Private Network | vRack private networking | IP Blocks, Service Integration, Tasks |
| Public Cloud Compute | Public Cloud instances | Instances, SSH keys, Flavors, Images |
| Storage | Object storage services | Containers, Objects, Regions |

🌍 Multi-Region Support

| Region | Endpoint | Description |
|——–|———-|————-|
| Europe | eu.api.ovh.com | European operations |
| Canada | ca.api.ovh.com | North American operations |
| US | api.us.ovhcloud.com | US operations |
| So you Start | eu.api.soyoustart.com | Budget dedicated servers |
| Kimsufi | eu.api.kimsufi.com | Entry-level servers |

📦 Installation

Community Nodes Installation

1. Go to Settings > Community Nodes in your n8n instance
2. Click Install and enter: n8n-nodes-ovh
3. Click Install and restart n8n

Manual Installation

Install in your n8n root directory
npm install n8n-nodes-ovh

Docker Installation

Add to your n8n Dockerfile
RUN cd /data && npm install n8n-nodes-ovh

🔑 Authentication

API Credentials Setup

1. Create OVH API Credentials
– Visit: OVH API Console
– Choose your region endpoint
– Set required permissions (see below)
– Generate your credentials

2. Configure in n8n
– Create new OVH API credential
– Enter your Application Key, Application Secret, and Consumer Key
– Select your Endpoint region

Required API Permissions

#### Core Services

Account Management
GET /me*
PUT /me*
POST /me*
DELETE /me*
Domain Services
GET /domain*
PUT /domain*
POST /domain*
DELETE /domain*
Dedicated Server
GET /dedicated/server*
PUT /dedicated/server*
POST /dedicated/server*
DELETE /dedicated/server*

#### Cloud Services

AI Services
GET /cloud/project//ai
PUT /cloud/project//ai
POST /cloud/project//ai
DELETE /cloud/project//ai
Kubernetes
GET /cloud/project//kube
PUT /cloud/project//kube
POST /cloud/project//kube
DELETE /cloud/project//kube

#### Infrastructure Services

Hosted Private Cloud
GET /dedicatedCloud*
PUT /dedicatedCloud*
POST /dedicatedCloud*
DELETE /dedicatedCloud*
Private Network (vRack)
GET /vrack*
PUT /vrack*
POST /vrack*
DELETE /vrack*

🚀 Quick Start

Example: Create DNS Record

{
  "nodes": [
    {
      "name": "OVH Domain",
      "type": "n8n-nodes-ovh.ovhDomain",
      "parameters": {
        "resource": "dnsRecord",
        "operation": "create",
        "domain": "example.com",
        "recordType": "A",
        "subDomain": "www",
        "target": "192.168.1.100",
        "ttl": 3600
      }
    }
  ]
}

Example: Deploy AI Application

{
  "nodes": [
    {
      "name": "OVH AI",
      "type": "n8n-nodes-ovh.ovhAi",
      "parameters": {
        "resource": "app",
        "operation": "create",
        "projectId": "your-project-id",
        "name": "my-ai-app",
        "image": "tensorflow/tensorflow:latest",
        "region": "GRA"
      }
    }
  ]
}

📚 Documentation

Node References

| Node | Resource Types | Use Cases |
|——|—————-|———–|
| OVH AI | Apps, Jobs, Notebooks | ML model training, AI app deployment |
| OVH Account | Profile, Bills, Contacts | Account automation, billing workflows |
| OVH Dedicated Server | Servers, Network, Security | Infrastructure provisioning, monitoring |
| OVH Domain | Domains, DNS, Nameservers | Domain management, DNS automation |
| OVH Hosted Private Cloud | VMware infrastructure | Private cloud orchestration |
| OVH Kubernetes | Clusters, Nodes, Security | Container orchestration |
| OVH Order (Beta) | Carts, Coupons, Checkout | Order automation, cart management |
| OVH Private Network | vRack, Services, IP blocks | Network isolation, service integration |

Advanced Features

• 🔄 Error Handling: Comprehensive error messages with troubleshooting steps
• ✅ Input Validation: Parameter validation prevents API errors
• 🌐 Dynamic Endpoints: Automatic region detection and endpoint selection
• 📊 Consistent Responses: Standardized data formats across all nodes
• 🔒 Secure Authentication: OVH API v1 signature implementation
• ⏱️ Clock Drift Tolerance: Requests are signed against OVH’s own clock (/auth/time), so a host whose clock is off no longer fails with QUERYTIMEOUT / “Query out of time”
• 🧰 Usable as AI Tool: Every node can be attached to an AI Agent

Downloading an Invoice

Account → Bill → Download returns the invoice PDF as binary data. Pick the
output field with Put Output File in Field (default data), then chain a
Write Binary File, Google Drive, or e-mail node.

The node resolves the invoice’s pdfUrl itself — OVH has no
/me/bill/{billId}/download route, which is why earlier versions failed with a
404 on the bill ID.

Subsidiary and Currency

Order → Cart → Create, Order → Cart Item → Add and
Order → Domain Check → Check Availability all expose an OVH Subsidiary
field. Prices and availability are returned in that subsidiary’s currency, so
set it to your own country instead of leaving the default FR / EUR.

🛠️ Development

Publishing

The package is published from GitHub Actions with an
npm provenance
statement (.github/workflows/publish.yml), as required for n8n community node
verification. Set the NPM_TOKEN repository secret and publish by creating a
GitHub release.

🤝 Support

Community

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• n8n Community: n8n Community Forum

Professional Support

For enterprise support and custom development:

• Website: ascenzia.fr
• Services: AI agent creation, workflow automation, custom integrations

📄 License

MIT License – see LICENSE file for details.

🏷️ Version History

Unreleased

• 🐛 Fix: Account → Bill → Download no longer hits the non-existent /me/bill/{billId}/download route; it resolves the invoice pdfUrl and returns the PDF as binary data (#2)
• 🐛 Fix: requests are signed against OVH’s server clock, removing spurious 400 QUERYTIMEOUT / “Query out of time” errors (#2)
• 🐛 Fix: ovhSubsidiary is no longer hardcoded to FR in Domain Check and in the plan/configuration dropdowns (#3)
• ♻️ Request signing moved into the ovhApi credential; all nodes now go through httpRequestWithAuthentication
• ✨ All 13 nodes are registered, marked usableAsTool, ship light/dark icons and emit pairedItem links
• ✅ Passes npx @n8n/scan-community-package static checks (#4)

v0.15.22 – Previous

• 🆕 Beta: OVH Order node for cart and order management
• ✨ Support for cart operations, coupons, and checkout
• 🔧 Enhanced endpoint management across all nodes

v0.15.19 – Older

• ✨ Multi-region endpoint support
• 🐛 Enhanced error handling with troubleshooting
• 🔧 Improved DELETE operations responses
• ✅ Parameter validation and input sanitization
• 🆕 New OVH Hosted Private Cloud node

Previous Versions

• v0.15.x: Enhanced stability and error handling
• v0.14.x: Multi-node activation and testing
• v0.13.x: Core functionality implementation

—

Developed with ❤️ by Ascenzia – Your trusted partner for AI automation and workflow solutions.