The Amazon API Gateway console is the quickest way to get started with Amazon API Gateway.  It provides a web-based interface for building, deploying, managing and monitoring your APIs. The Amazon API Gateway console provides a comprehensive UI to guide you through the process of creating an API. Programmatic access is also available through the Amazon API Gateway APIs.

Get Started with Amazon API Gateway

Create a Free Account

The Amazon API Gateway free tier includes one million API calls per month for up to 12 months.

The Amazon API Gateway Developer Guide provides several walkthrough tutorials with hands-on exercises to help you get started using Amazon API Gateway.

In this walkthrough, you will learn how to use Amazon API Gateway to create a custom API, connect your custom API to a set of AWS Lambda functions, and then call the AWS Lambda functions from your API.

Learn more >>

In this walkthrough, you will learn how to use Amazon API Gateway to connect a custom API to an HTTP endpoint through a REST proxy.

Learn more >>


In this walkthrough, you will learn how to use models and mapping templates in Amazon API Gateway to transform the output of an API call from one data format to another.

Learn more >>

You can quickly and easily create a custom API using the API Gateway console. For a simple “Hello World” example, follow these steps:

1. Visit the Amazon API Gateway console.

2. Select an existing REST API or create a new one by entering a name for the API.

3. On the REST API tree view, click the Actions button to “Create Resource”.

4. Choose a name for your resource, such as “cars”.

5. With the new resource selected, click the button to create a new method and select the HTTP verb associated with the method (for example, GET).

6. Select the integration type (for example, HTTP Proxy), and enter the URL the API Gateway should call.

7. Define how requests and responses are transformed using a transform template, or simply accept the default settings to pass all of the request and response data through without applying any transformation.

8. Configure the method’s security settings.

9. Deploy your new API to a stage.

10.From the Stage management screen, set up caching and throttling configuration.

11.On the Client Platforms tab in the Amazon API Gateway console, click the button to download the Android, iOS SDK, or Javascript library that contains helper methods to call your sayHello operation. The SDK library makes calling your APIs similar to calling a local method. The client SDK automatically handles retries, informing the developer of network or other fault conditions. The SDK library includes the logic necessary to authenticate the client application to your APIs.

12.Integrate the downloaded SDK into your mobile application. Write the code to invoke your custom API. For example, to invoke the getCar(int carId) API in an iOS application:



NSString *response = [MyServiceClient getCar:1323];

NSLog( @”Response was [%@]”, response );


13. Run your application.