---
title: "First Steps with the OVHcloud APIs"
description: "Learn how to use OVHcloud APIs"
url: https://docs.ovhcloud.com/en/guides/manage-and-operate/api/first-steps
lang: en
lastUpdated: 2025-05-13
---
# First Steps with the OVHcloud APIs
## Objective
The APIs available on [https://api.ovh.com/](https://eu.api.ovh.com/) allow you to purchase, manage, update and configure OVHcloud products without using a graphical interface such as the Control Panel.
**Learn how to use OVHcloud APIs and how to pair them with your applications.**
## Requirements
- You have an active OVHcloud account and know its credentials.
- You are on the [OVHcloud API](https://eu.api.ovh.com/) web page.
## Instructions
:::warning
OVHcloud is providing you with services for which you are responsible, with regard to their configuration and management. You are therefore responsible for ensuring they function correctly.
This guide is designed to assist you in common tasks as much as possible. Nevertheless, we recommend contacting a specialised provider and/or the software publisher for the service if you encounter any difficulties. We will not be able to assist you ourselves. You can find more information in the [“Go further”](#gofurther) section of this guide.
:::
### Simple Use
#### Sign in to OVHcloud APIs
On the [OVHcloud API](https://eu.api.ovh.com/)
page, click `Explore the OVH API
` to view the list of APIs.
To use the APIs on your products, you must sign in to this site using your OVHcloud credentials.
- Click Authentication in the upper left.
- Select Login with OVHcloud SSO.
- Enter your OVHcloud credentials.
- Click Authorize to allow performing API calls through the console.
:::info
If your OVHcloud account is protected by [two-factor authentication](/en/guides/account-and-service-management/account-information/secure-ovhcloud-account-with-2fa.md), you will also need to enter the code generated by SMS or OTP mobile application or U2F key.
:::
#### Explore available products on APIs
You can see the list of OVHcloud products that can be managed with APIs on the left menu. This list is sorted alphabetically.
For example, to view the domain name APIs, click **/domain** in the list.
After you click the product, a list of the product's APIs appears below.
You can also use the selector on the left of the list of products to switch between the **/v1** and **/v2** branches of the API.
If you're not familiar with the API branches, you can read the following [documentation about the API v2](/en/guides/manage-and-operate/api/apiv2.md).
#### Run API
There are 4 types of APIs available that use what are called HTTP methods:
**GET**
The GET method is used to retrieve data from a resource.
For example, to retrieve a list of your domain names, use the following API:
🇪🇺EU▾
[GET/domain](https://eu.api.ovh.com/console/?section=/domain&branch=v1#get-/domain)
**POST**
The POST method is used to send additional data to the resource.
For example, to add a record to your DNS zone, use the following API:
🇪🇺EU▾
[POST/domain/zone/{zoneName}/record](https://eu.api.ovh.com/console/?section=/domain&branch=v1#post-/domain/zone/-zoneName-/record)
**PUT**
The PUT method is used to replace the current data in the resource with the data in the query.
For example, if you have mistakenly set a record in your DNS zone, use the following API:
🇪🇺EU▾
[PUT/domain/zone/{zoneName}/record/{id}](https://eu.api.ovh.com/console/?section=/domain&branch=v1#put-/domain/zone/-zoneName-/record/-id-)
**DELETE**
The DELETE method is used to delete the called resource.
For example, if you do not want to keep the DNS record that you added to your DNS zone, use the following API:
🇪🇺EU▾
[DELETE/domain/zone/{zoneName}/record/{id}](https://eu.api.ovh.com/console/?section=/domain&branch=v1#delete-/domain/zone/-zoneName-/record/-id-)
##### **API parameters**
After you click the API you want, the **Request** section allows you to assign variables for its application.
For example, when adding a TXT record to your DNS zone, you will optimise the following settings:
Once you have set the parameters, you can launch the API by clicking `EXECUTE
`.
The `Response` tab displayed will give you the API execution report.
The `PHP` and `Python` tabs contain the elements to be added to your script according to the language used.
### Advanced usage: pair OVHcloud APIs with an application
#### Create your app keys
Any application that wants to communicate with the OVHcloud API must be declared in advance.
To do this, click the following link: [https://eu.api.ovh.com/createToken/](https://eu.api.ovh.com/createToken/).
Fill in your OVHcloud customer ID, password, and application name. The name will be useful later if you want to allow others to use it.
You can also add a description of the application and a validity period.
The `Rights`
field allows you to restrict the use of the application to certain APIs.
In order to allow all OVHcloud APIs for an HTTP method, put an asterisk (`*`
) into the field, as in the following example where the GET method is allowed for all APIs:
After you click `Create keys
`, you will be issued three keys:
- the application key, called **AK**. For example:
```console
7kbG7Bk7S9Nt7ZSV
```
- your secret application key, not to be disclosed, called **AS**. For example:
```console
EXEgWIz07P0HYwtQDs7cNIqCiQaWSuHF
```
- a secret "**consumer key**", not to be disclosed, called **CK**. For example:
```console
MtSwSrPpNjqfVSmJhLbPyr2i45lSwPU1
```
In this case, the **CK** key is attached to your account.
The **CK** token can be used for rights delegation. See the following guide for more information: [How to manage a customer’s account via OVHcloud API](/en/guides/manage-and-operate/api/first-steps.md)
#### First API Usage
Once you have obtained your three keys (**AK**, **AS**, **CK**), you can sign API requests. The signature is calculated as follows:
```console
"$1$" + SHA1_HEX(AS+"+"+CK+"+"+METHOD+"+"+QUERY+"+"+BODY+"+"+TSTAMP)
```
To simplify the development of your applications, OVHcloud provides API wrappers in multiple languages.
Using them will help you to avoid worrying about signing requests, so that you can focus on developing your application.
- _Go_ : [https://github.com/ovh/go-ovh](https://github.com/ovh/go-ovh)
- _Perl_ : [https://github.com/ovh/perl-ovh](https://github.com/ovh/perl-ovh)
- _Python_ : [https://github.com/ovh/python-ovh](https://github.com/ovh/python-ovh)
- _PHP_ : [https://github.com/ovh/php-ovh](https://github.com/ovh/php-ovh)
- _Node.js_ : [https://github.com/ovh/node-ovh](https://github.com/ovh/node-ovh)
- _C#_ : [https://github.com/ovh/csharp-ovh](https://github.com/ovh/csharp-ovh)
Here is an example of how to use the `/me` section to manage your OVHcloud account:
```python
import ovh
# Instantiate. Visit https://api.ovh.com/createToken/?GET=/me
# to get your credentials
client = ovh.Client(
endpoint='ovh-eu',
application_key='',
application_secret='',
consumer_key='',
)
# Print nice welcome message
print("Welcome", client.get('/me')['firstname'])
```
#### List and revoke your keys
To list and revoke keys, you can use the [API portal](https://eu.api.ovh.com/)
or the OVHcloud Control Panel
:
**Using the API portal**
- List the keys IDs with the following call:
- Get key details with the following call:
- Revoke a key with the following call:
🇪🇺EU▾
[DELETE/me/api/application/{applicationId}](https://eu.api.ovh.com/console/?section=/me&branch=v1#delete-/me/api/application/-applicationId-)
**Using the OVHcloud Control Panel**
Go to the API keys page.
## Go further [](#)
[Managing a Domain Name with the OVHcloud API](/en/guides/web-cloud/domains/api-domain-intro.md)
[How to manage a customer’s account via OVHcloud API](/en/guides/manage-and-operate/api/first-steps.md)
Join our [community of users](https://community.ovhcloud.com/).