> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nadles.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add API

> You can add a new API either by importing an OpenAPI specification or by filling out the form manually.

## From OpenAPI file

Nadles supports importing OpenAPI **v3.0** specifications. It is the easiest way to get your API up and running.

* Navigate to **My APIs**.

* Click **Import OpenAPI file**.

<Frame>
  <img src="https://mintcdn.com/nadles/WGoKyNQHhztkDHRn/images/api-management/import-openapi.png?fit=max&auto=format&n=WGoKyNQHhztkDHRn&q=85&s=3f9f4a3cb4eec0ffa54ca5d7dd060680" alt="" width="1884" height="790" data-path="images/api-management/import-openapi.png" />
</Frame>

* Choose the subdomain for your API, select the OpenAPI file and click **Submit**.

<Info>
  By default, Nadles let's you choose a subdomain for your API, so the URL to access your API looks like `https://<subdomain>.p.nadles.com/`

  Later, you can configure Nadles API Gateway to use a custom domain for your API, e.g. `https://api.mydomain.com`. [Learn more](/api-management/custom-domain).
</Info>

The OpenAPI definition is imported along with all endpoints. If there are several elements in the "servers" array, the first one is used.

<Warning>
  After importing the file, please check the correctness of the configuration on the API settings and Endpoints pages.
</Warning>

## Manually

### Adding a new API

* Navigate to **My APIs**.

* Click **"Add new API"**.

* Fill in the details of your API.

<Frame>
  <img src="https://mintcdn.com/nadles/WGoKyNQHhztkDHRn/images/api-management/add-api.png?fit=max&auto=format&n=WGoKyNQHhztkDHRn&q=85&s=af46941b18b4def15461c2f127bdf468" alt="" width="2432" height="3202" data-path="images/api-management/add-api.png" />
</Frame>

**Name** <Icon icon="input-text" />

The name of your API. This name your customers will see on the checkout page.

**Base URL** <Icon icon="input-text" />

The base URL for all API endpoints.

The full URL to which Nadles API Gateway will proxy users' requests, is formed as `Base URL + Endpoint URL`.

<Info>
  If your API has the following endpoints:

  `https://api.mydomain.com/weather-forecast/`
  `https://api.mydomain.com/current-weather/`

  then `https://api.mydomain.com/` is the base URL.
</Info>

<Warning>
  Do not add path parameters or query string to the base URL of your API. That can be done using "Transformations".
</Warning>

**Short description** <Icon icon="input-text" />

Shown to your customers on the checkout page if no full description is provided.

**Full description** <Icon icon="input-text" />

Shown to your customers on the checkout page.

**Link to your Terms of Service** <Icon icon="input-text" />

Link to your website page with the Terms of Service for your API. Shown to your customers on the checkout page.

**Link to your API documentation** <Icon icon="input-text" />

Link to your website page with the API documentation. Shown to your customers on the checkout page.

**API subdomain** <Icon icon="input-text" />

By default, your API is accessible on Nadles domain and the access URL looks like `https://<subdomain>.p.nadles.com/`

Later, you can configure Nadles API Gateway to use a custom domain for your API, e.g. `https://api.mydomain.com` [Learn more](api-management/custom-domains)

* Click **Submit**.

* After the API is added, you are redirected to the dashboard.

* On the dashboard there is now the Nadles API URL that should be used by your customers to make requests to the API.

To attach a custom domain to your API, check out [this page](api-management/custom-domains).

### Adding endpoints

* Go to **Endpoints** section in the menu and click **Add new endpoint**.

* Choose a HTTP method and enter the endpoint URL relative to the base URL.

<Frame>
  <img src="https://mintcdn.com/nadles/WGoKyNQHhztkDHRn/images/api-management/add-endpoint.png?fit=max&auto=format&n=WGoKyNQHhztkDHRn&q=85&s=05478059c50453a7c7e1e8b11181f796" alt="" width="2422" height="1418" data-path="images/api-management/add-endpoint.png" />
</Frame>

<Info>
  If your API has the following endpoints:

  `https://api.mydomain.com/weather-forecast/`
  `https://api.mydomain.com/current-weather/`

  then `https://api.mydomain.com` is the base URL and `/weather-forecast/` and `/current-weather/` are the endpoint URLs.
</Info>

* Path parameters can be used in endpoint URLs. These parameters can be used later to configure billable metrics, request transformations and rejection rules.

<Info>
  You can specify endpoint URLs like this:

  `GET /weather-forecast/{city}`

  In this case, you will be able to later configure Nadles API Gateway to limit access to weather forecast for certain cities or charge different price for different cities.
</Info>

* Click **Submit**.

Once all endpoints are added, it's time to [set up user authentication](https://docs.nadles.com/api-management/authentication/).