> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblHttpCallRequestSetHeader

> XblHttpCallRequestSetHeader

# XblHttpCallRequestSetHeader

Set a request header for the HTTP call.

## Syntax

```cpp theme={null}
HRESULT XblHttpCallRequestSetHeader(  
         XblHttpCallHandle call,  
         const char* headerName,  
         const char* headerValue,  
         bool allowTracing  
)  
```

### Parameters

*call*   \_In\_\
Type: [XblHttpCallHandle](/reference/live/xsapi-c/http_call_c/handles/xblhttpcallhandle)

The handle of the HTTP call.

*headerName*   \_In\_z\_\
Type: char\*

UTF-8 encoded request header name for the HTTP call.

*headerValue*   \_In\_z\_\
Type: char\*

UTF-8 encoded request header value for the HTTP call.

*allowTracing*   \_In\_\
Type: bool

Set to false to skip tracing this request header, for example if it contains private information.

### Return value

Type: HRESULT

Result code for this API operation. Possible values are S\_OK, E\_INVALIDARG, E\_OUTOFMEMORY, or E\_FAIL.

## Remarks

This must be called prior to calling [XblHttpCallPerformAsync](/reference/live/xsapi-c/http_call_c/functions/xblhttpcallperformasync).

## Requirements

**Header:** http\_call\_c.h

**Library:** Microsoft.Xbox.Services.14x.GDK.C.lib

## See also

[http\_call\_c](/reference/live/xsapi-c/http_call_c/http_call_c_members)


## Related topics

- [XblHttpCallPerformAsync](/reference/live/xsapi-c/http_call_c/functions/xblhttpcallperformasync.md)
- [XblHttpCallRequestSetLongHttpCall](/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetlonghttpcall.md)
- [XblHttpCallRequestSetRequestBodyBytes](/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetrequestbodybytes.md)
- [XblHttpCallRequestSetRequestBodyString](/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetrequestbodystring.md)
- [XblHttpCallRequestSetRetryAllowed](/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetretryallowed.md)
