Skip to content

API Settings

You can always change the configuration of your API on the Settings page.

General settings


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

Base URL

The base URL for all API endpoints.

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


If your API has the following endpoints:
then is the base URL.

Short description

Short description is shown to your customers in case the full description is not filled in.

Full description

Full description is shown to your customers on the checkout pages and in the self-service portal.

Please provide a link to your Terms of Service/Terms and Conditions if you want it to be displayed to customers.

Please specify here a link to your API documentation if you want it to be displayed to customers.

Nadles Gateway settings

Nadles Gateway API subdomain

By default, Nadles let's you choose a subdomain for your API, and the URL to access it looks like


Later, you can configure Nadles API Gateway to use a custom domain for your API, e.g. Learn more.

Authentication instructions for API users

This is a textual description of how your API users should authenticate when making API calls. The text will be shown to your customers on the checkout and subscription pages.

By default, Nadles Gateway expects the access token to be sent in the X-Billing-Token header.

This behavior can be changed: you can flexibly configure Nadles Gateway to look for the access token in any other header (including the standard Authorization: Bearer scheme) or in an arbitrary field in JSON request body.

If you decide to configure user authentication differently, make sure to update the Authentication instructions for API users field.

See the Authentication chapter of this documentation to learn more.

Custom domain name

Nadles allows attaching custom domain names to your API, so that instead of the default https://<subdomain> URL, customers use your own domain name to make API calls.

Read more about that in the Custom domain name section of this documentation.