n8n-nodes-ovh

[] [] [] []

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)

🌍 Multi-Region Support

📦 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

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 QUERY_TIME_OUT / "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 QUERY_TIME_OUT / "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.