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

# 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](https://docs.xbox.com/reference/live/xsapi-c/http_call_c/handles/xblhttpcallhandle.md)

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](https://docs.xbox.com/reference/live/xsapi-c/http_call_c/functions/xblhttpcallperformasync.md).

## Requirements

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

**Library:** Microsoft.Xbox.Services.142.C.lib or Microsoft.Xbox.Services.143.C.lib

## See also

[http\_call\_c](https://docs.xbox.com/reference/live/xsapi-c/http_call_c/http_call_c_members.md)


## Related topics

- [http_call_c (contents)](https://docs.xbox.com/reference/live/xsapi-c/http_call_c/http_call_c_members.md)
- [Web requests overview](https://docs.xbox.com/build/console-features/networking/web-requests/http-networking.md)
- [XblHttpCallPerformAsync](https://docs.xbox.com/reference/live/xsapi-c/http_call_c/functions/xblhttpcallperformasync.md)
- [XblHttpCallRequestSetLongHttpCall](https://docs.xbox.com/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetlonghttpcall.md)
- [XblHttpCallRequestSetRequestBodyBytes](https://docs.xbox.com/reference/live/xsapi-c/http_call_c/functions/xblhttpcallrequestsetrequestbodybytes.md)
