Knowledge Base

OVH API Credentials, Endpoints & Subsidiaries

All three modules authenticate against the OVH API with a three-part token: an application key, an application secret and a consumer key. Mint one at the token-creation page of the endpoint you sell on:

Endpoint Token page
ovh-eu https://eu.api.ovh.com/createToken/
ovh-ca https://ca.api.ovh.com/createToken/
ovh-us https://api.us.ovhcloud.com/createToken/
kimsufi-eu / kimsufi-ca https://eu.api.kimsufi.com/createToken/ (or ca.)
soyoustart-eu / soyoustart-ca https://eu.api.soyoustart.com/createToken/ (or ca.)

Tokens are endpoint-specific. A token minted on ovh-eu is invalid on ovh-ca or ovh-us, and the US endpoint is a separate legal entity with its own account and credentials. Legacy kimsufi-*/soyoustart-* accounts can manage servers only — new Eco orders go through the main ovh-eu/ovh-ca endpoints.

Rights per module

Grant GET, POST, PUT and DELETE on:

Module API rights
OVH VPS /me/*, /order/*, /vps/*, /ip/*, /services/*
OVH Dedicated Servers /me/*, /order/*, /dedicated/*, /ip/*, /services/*
OVH Public Cloud GET /me, plus /cloud/*

Set the token validity to unlimited — the modules use it for daily automation.

Subsidiaries (VPS & Dedicated)

The OVH Subsidiary on the module row tells OVH which regional catalog and legal entity to order from. It must match the endpoint or the row will not save:

Endpoint Valid subsidiaries
ovh-eu (and kimsufi-eu / soyoustart-eu) CZ, DE, ES, EU, FI, FR, GB, IE, IT, LT, MA, NL, PL, PT, SN, TN
ovh-ca (and kimsufi-ca / soyoustart-ca) CA, QC, WE, WS, ASIA, AU, SG, IN
ovh-us US

Use the subsidiary your OVH account was registered under (it appears on your OVH invoices). The Public Cloud module has no subsidiary — it works inside an existing project instead.

Adding the credentials in Blesta

On the module's Manage page add a row — OVH Account (VPS/Dedicated: name, endpoint, subsidiary and the three keys) or Cloud Project (Public Cloud: name, endpoint, the three keys and the project ID). The module calls the OVH API (GET /me) before saving, so a row that saves is a row that works; if saving fails, re-check the endpoint/subsidiary pairing and the token rights. The application secret and consumer key are stored encrypted.

Heads-up: auto-ordering (VPS and Dedicated) pays with the OVH account's preferred payment method. Set one in the OVH Control Panel under Billing > Payment methods before selling, or orders will fail at checkout.

Please rate this article to help us improve our Knowledge Base.

0 0