Integrating with Lambda

~8 min read

How API Gateway turns a Lambda function into a real HTTP endpoint.

Integrating with Lambda is a Pro topic

Sign in, then upgrade to Pro or Power to unlock this topic and the full AWS curriculum.

Key points

  • Lambda Proxy integration passes the full request as an event and expects a specific {statusCode, headers, body} response shape
  • Returning a plain object instead of this expected shape causes a confusing 500 error
  • Non-proxy integrations allow custom request/response transformation but require much more configuration
  • Proxy integration is the default, recommended choice for the vast majority of Lambda-backed APIs