Why aren't the HTTP headers passed from API Gateway to Step Functions?

Question

I have an endpoint set up on API Gateway with integration to a step function - the integration is working well and my function is executed. However I have a need to access the headers on the initial request to the api gateway (as they need to be passed on to an API call made by one of the steps in the step function) I've added the http headers to the API Gateway Method Request and also done this in the HTTP Headers section of the Integration Request, then in the mapping template I have

```
#set($inputbody = $input.json('$'))
{
   "method": "$context.httpMethod",
   "input": "$util.escapeJavaScript($inputbody)",
   "stateMachineArn": "MyStateMachineARN",
   "headers": {
        #foreach($param in $input.params().header.keySet())
        "$param": "$util.escapeJavaScript($input.params().header.get($param))"
        #if($foreach.hasNext),#end
        #end
    }
}
```

When I test this I see the headers in the logs after the request body has been transformed - before it executes the step function

```
request body after transformations: {
   "method": "POST",
   "input": "{\"surname\":\"TESTSURNAME\"}",
   "stateMachineArn": "MyStateMachineARN",
   "headers": {
                "HeaderA": "ValueA"
        ,                "HeaderB": "ValueB"
                    }
}
```

But in the step functions I am struggling to see the headers - the input I can see at the start of the execution is only

```
{
   "surname::"TESTSURNAME"
}
```

I have inputPath set to $ and the same for the payload.

All the suggestions I've found online point to the mapping template but I can not get it to work - any ideas what I'm doing wrong?

Answer

You should modify your mapping template to include the headers as part of the Input param as this is the only field which is passed to the Step Functions execution.

Something like this (did not actually try it so there may be some syntax mistakes):

```
#set($inputbody = $input.json('$'))
{
   "method": "$context.httpMethod",
   "input": { 
       "$util.escapeJavaScript($inputbody)",
       "headers": {
          #foreach($param in $input.params().header.keySet())
          "$param": "$util.escapeJavaScript($input.params().header.get($param))"
          #if($foreach.hasNext),#end
          #end
      }
   }
   "stateMachineArn": "MyStateMachineARN"
}
```

Why aren't the HTTP headers passed from API Gateway to Step Functions?

Relevant questions

Return HTML to browser from API Gateway using Lambda Proxy Integration