[Common Issue] Understanding and using Netlify's API


Did you know that Netlify has an extensive public API? Anything that you configure in our Admin UI at https://app.netlify.com is managed using this same API, and you’re welcome to use it to create and configure your site(s).

We have an article on API Usage in our official documentation which shows how to do some common tasks like deploying your site and configuring it in great detail. It also talks about your options for authentication (since most endpoints require authentication), and also gives examples of usage with the command line http tool curl, so this article won’t rehash that information.

Some details not covered in that article that will be useful as you explore the API:

The most important advice I can give you about using our API is to watch how we do it! Our entire admin UI works via this API, so checking to see how we use the API in-app will be the best guide to using every feature. You can use your browser’s developer tools to accomplish this! While we do try to keep our documentation up to date - you can be sure that what is live in production works today! :slight_smile: . This can also help you understand what the normal "order of operations" is when creating a site - you’ll see the endpoints and HTTP methods used, and discover many of the options you can set.

You may also be interested in this article about linking a repo via the API.

Let us know what you think!

Split testing Under the Hood?
Netlify API for adding DNS records
[Common Issue] Configure site DNS through API
How to dynamically create a subdomain?