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.
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.
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.
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.