How to set the Content-Type header for an HttpClient request?

req.Content.Headers.ContentType = new MediaTypeHeaderValue("application/octet-stream"); 

If you don't mind a small library dependency, Flurl.Http [disclosure: I'm the author] makes this uber-simple. Its PostJsonAsync method takes care of both serializing the content and setting the content-type header, and ReceiveJson deserializes the response. If the accept header is required you'll need to set that yourself, but Flurl provides a pretty clean way to do that too:

using Flurl.Http; var result = await "http://example.com/" .WithHeader("Accept", "application/json") .PostJsonAsync(new { ... }) .ReceiveJson<TResult>(); 

Flurl uses HttpClient and Json.NET under the hood, and it's a PCL so it'll work on a variety of platforms.

PM> Install-Package Flurl.Http 

try to use TryAddWithoutValidation

 var client = new HttpClient(); client.DefaultRequestHeaders.TryAddWithoutValidation("Content-Type", "application/json; charset=utf-8"); 

.Net tries to force you to obey certain standards, namely that the Content-Type header can only be specified on requests that have content (e.g. POST, PUT, etc.). Therefore, as others have indicated, the preferred way to set the Content-Type header is through the HttpContent.Headers.ContentType property.

With that said, certain APIs (such as the LiquidFiles Api, as of 2016-12-19) requires setting the Content-Type header for a GET request. .Net will not allow setting this header on the request itself -- even using TryAddWithoutValidation. Furthermore, you cannot specify a Content for the request -- even if it is of zero-length. The only way I could seem to get around this was to resort to reflection. The code (in case some else needs it) is

var field = typeof(System.Net.Http.Headers.HttpRequestHeaders) .GetField("invalidHeaders", System.Reflection.BindingFlags.NonPublic | System.Reflection.BindingFlags.Static) ?? typeof(System.Net.Http.Headers.HttpRequestHeaders) .GetField("s_invalidHeaders", System.Reflection.BindingFlags.NonPublic | System.Reflection.BindingFlags.Static); if (field != null) { var invalidFields = (HashSet<string>)field.GetValue(null); invalidFields.Remove("Content-Type"); } _client.DefaultRequestHeaders.TryAddWithoutValidation("Content-Type", "text/xml"); 

Edit:

As noted in the comments, this field has different names in different versions of the dll. In the source code on GitHub, the field is currently named s_invalidHeaders. The example has been modified to account for this per the suggestion of @David Thompson.

For those who troubled with charset

I had very special case that the service provider didn't accept charset, and they refuse to change the substructure to allow it... Unfortunately HttpClient was setting the header automatically through StringContent, and no matter if you pass null or Encoding.UTF8, it will always set the charset...

Today i was on the edge to change the sub-system; moving from HttpClient to anything else, that something came to my mind..., why not use reflection to empty out the "charset"? ... And before i even try it, i thought of a way, "maybe I can change it after initialization", and that worked.

Here's how you can set the exact "application/json" header without "; charset=utf-8".

var jsonRequest = JsonSerializeObject(req, options); // Custom function that parse object to string var stringContent = new StringContent(jsonRequest, Encoding.UTF8, "application/json"); stringContent.Headers.ContentType.CharSet = null; return stringContent; 

Note: The null value in following won't work, and append "; charset=utf-8"

return new StringContent(jsonRequest, null, "application/json"); 

EDIT

@DesertFoxAZ suggests that also the following code can be used and works fine. (didn't test it myself, if it work's rate and credit him in comments)

stringContent.Headers.ContentType = new MediaTypeHeaderValue("application/json"); 

EDIT 2

.NET 8 (Or maybe all .NET or even .NET Core version)

As @EionRobb explained, the new .NET does not behave same as the old one, setting the stringContent.Headers.ContentType to null is the answer, and this new MediaTypeHeaderValue("application/json") may not work. Just Updated, Not tested by myself.

The trick is that you can just set all kinds of headers like:

HttpRequestMessage request = new HttpRequestMessage(); request.Headers.Add("Accept-Language", "en"); //works OK 

but not any header. For example:

request.Headers.Add("Content-Type", "application/json");//wrong 

will raise the run-time exception Misused header name. It may seem that this will work:

request.Headers.Add( HttpRequestHeader.ContentType.ToString(), //useless "application/json" ); 

but this gives a useless header named ContentType, without the hyphen. Header names are not case-sensitive, but are very hyphen-sensitive.

The solution is to declare the encoding and type of the body when adding the body to the Content part of the http request:

string Body = "..."; request.Content = new StringContent(Body, Encoding.UTF8, "application/json"); 

Only then the applicable http header is automatically added to the request, like:

Content-Type: application/json; charset=utf-8 

It was hard to find this out, with Fiddler, on a machine without a proxy server. Visual Studio used to have a Network Tool where you could inspect all headers, but only in version 2015, not in newer versions 2017 or 2022. If you use the debugger to inspect request.Headers, you will not find the header added automagically by StringContent().

Some extra information about .NET Core (after reading erdomke's post about setting a private field to supply the content-type on a request that doesn't have content):

After debugging my code, I can't see the private field to set via reflection - so I thought I'd try to recreate the problem.

I have tried the following code using .NET 4.6:

HttpRequestMessage httpRequest = new HttpRequestMessage(HttpMethod.Get, @"myUrl"); httpRequest.Content = new StringContent(string.Empty, Encoding.UTF8, "application/json"); HttpClient client = new HttpClient(); Task<HttpResponseMessage> response = client.SendAsync(httpRequest); //I know I should have used async/await here! var result = response.Result; 

And, as expected, I get an aggregate exception with the content

Cannot send a content-body with this verb-type.

However, if I do the same thing with .NET Core (1.1), I don't get an exception. My request was quite happily answered by my server application, and the content-type was picked up.

Call AddWithoutValidation instead of Add (see this MSDN link).

Alternatively, I'm guessing the API you are using really only requires this for POST or PUT requests (not ordinary GET requests). In that case, when you call HttpClient.PostAsync and pass in an HttpContent, set this on the Headers property of that HttpContent object.

You can use this it will be work!

HttpRequestMessage msg = new HttpRequestMessage(HttpMethod.Get,"URL"); msg.Content = new StringContent(string.Empty, Encoding.UTF8, "application/json"); HttpResponseMessage response = await _httpClient.SendAsync(msg); response.EnsureSuccessStatusCode(); string json = await response.Content.ReadAsStringAsync(); 

For anyone that needs the content-type header for Get etc., while in an older .NET version it is possible to use the answer of @erdomke at https://stackoverflow.com/a/41231353, this unfortunately no longer works in the newer .NET Core versions.

The following code has been tested to work with .NET Core 3.1 and from the source code on GitHub it looks like it should work with newer .NET versions as well.

private void FixContentTypeHeaders() { var assembly = typeof(System.Net.Http.Headers.HttpRequestHeaders).Assembly; var assemblyTypes = assembly.GetTypes(); var knownHeaderType = assemblyTypes.FirstOrDefault(n => n.Name == "KnownHeader"); var headerTypeField = knownHeaderType? .GetFields(System.Reflection.BindingFlags.NonPublic | System.Reflection.BindingFlags.Instance) .FirstOrDefault(n => n.Name.Contains("HeaderType")); if (headerTypeField is null) return; var headerTypeFieldType = headerTypeField.FieldType; var newValue = Enum.Parse(headerTypeFieldType, "All"); var knownHeadersType = assemblyTypes.FirstOrDefault(n => n.Name == "KnownHeaders"); var contentTypeObj = knownHeadersType.GetFields().FirstOrDefault(n => n.Name == "ContentType").GetValue(null); if (contentTypeObj is null) return; headerTypeField.SetValue(contentTypeObj, newValue); } 

Ok, it's not HTTPClient but if u can use it, WebClient is quite easy:

using (var client = new System.Net.WebClient()) { client.Headers.Add("Accept", "application/json"); client.Headers.Add("Content-Type", "application/json; charset=utf-8"); client.DownloadString(...); } 

var content = new JsonContent(); content.Headers.ContentType = new MediaTypeHeaderValue("application/json"); content.Headers.ContentType.Parameters.Add(new NameValueHeaderValue("charset", "utf-8")); content.Headers.ContentType.Parameters.Add(new NameValueHeaderValue("IEEE754Compatible", "true")); 

It's all what you need.

With using Newtonsoft.Json, if you need a content as json string.

public class JsonContent : HttpContent { private readonly MemoryStream _stream = new MemoryStream(); ~JsonContent() { _stream.Dispose(); } public JsonContent(object value) { Headers.ContentType = new MediaTypeHeaderValue("application/json"); using (var contexStream = new MemoryStream()) using (var jw = new JsonTextWriter(new StreamWriter(contexStream)) { Formatting = Formatting.Indented }) { var serializer = new JsonSerializer(); serializer.Serialize(jw, value); jw.Flush(); contexStream.Position = 0; contexStream.WriteTo(_stream); } _stream.Position = 0; } private JsonContent(string content) { Headers.ContentType = new MediaTypeHeaderValue("application/json"); using (var contexStream = new MemoryStream()) using (var sw = new StreamWriter(contexStream)) { sw.Write(content); sw.Flush(); contexStream.Position = 0; contexStream.WriteTo(_stream); } _stream.Position = 0; } protected override Task SerializeToStreamAsync(Stream stream, TransportContext context) { return _stream.CopyToAsync(stream); } protected override bool TryComputeLength(out long length) { length = _stream.Length; return true; } public static HttpContent FromFile(string filepath) { var content = File.ReadAllText(filepath); return new JsonContent(content); } public string ToJsonString() { return Encoding.ASCII.GetString(_stream.GetBuffer(), 0, _stream.GetBuffer().Length).Trim(); } } 

By default Content-Type header is forbidden in GET methods, at least in -NET Framework implementation. I solve the problem using a custom Handler that inherits from the one used by HttpClient class. I override the SendAsync method which eliminates that header of the forbidden ones (otherwise you get an exception when you try to add the header to the request), and I include the header when the request has GET method:

public class GetRequestHandler : HttpClientHandler { public GetRequestHandler(): base() { } protected override Task<HttpResponseMessage> SendAsync( HttpRequestMessage request, CancellationToken cancellationToken) { FieldInfo invalidHeadersField = typeof(HttpHeaders).GetField("invalidHeaders", BindingFlags.NonPublic | BindingFlags.Instance) ?? typeof(HttpHeaders).GetField("_invalidHeaders", BindingFlags.NonPublic | BindingFlags.Instance); HashSet<string> invalidHeaders = (HashSet<string>)invalidHeadersField.GetValue(request.Headers); invalidHeaders.Remove("Content-Type"); if(request.Method == HttpMethod.Get) { request.Headers.Remove("Content-Type"); request.Headers.Add("Content-Type", "application/json"); } return base.SendAsync(request, cancellationToken); } 

}

Then, in the HttpClient constructor, i use this custom handler:

HttpClient client = new HttpClient(new GetRequestHandler()); 

Doing this, now this works well:

var response = await client.GetAsync(url); 

try to use HttpClientFactory

services.AddSingleton<WebRequestXXX>() .AddHttpClient<WebRequestXXX>("ClientX", config => { config.BaseAddress = new System.Uri("https://jsonplaceholder.typicode.com"); config.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json")); config.DefaultRequestHeaders.TryAddWithoutValidation("Content-Type", "application/json; charset=utf-8"); }); 

======================

public class WebRequestXXXX { private readonly IHttpClientFactory _httpClientFactory; public WebRequestXXXX(IHttpClientFactory httpClientFactory) { _httpClientFactory = httpClientFactory; } public List<Posts> GetAllPosts() { using (var _client = _httpClientFactory.CreateClient("ClientX")) { var response = _client.GetAsync("/posts").Result; if (response.IsSuccessStatusCode) { var itemString = response.Content.ReadAsStringAsync().Result; var itemJson = System.Text.Json.JsonSerializer.Deserialize<List<Posts>>(itemString, new System.Text.Json.JsonSerializerOptions { PropertyNameCaseInsensitive = true }); return itemJson; } else { return new List<Posts>(); } } } } 

I got the answer with RestSharp:

private async Task<string> GetAccessTokenAsync() { var client = new RestClient(_baseURL); var request = new RestRequest("auth/v1/login", Method.POST, DataFormat.Json); request.AddHeader("Content-Type", "application/json"); request.AddHeader("x-api-key", _apiKey); request.AddHeader("Accept-Language", "br"); request.AddHeader("x-client-tenant", "1"); ... } 

It worked for me.

Since .NET 5 we can use static JsonContent.Create method. https://docs.microsoft.com/en-us/dotnet/api/system.net.http.json.jsoncontent.create?view=net-5.0

It will set request Content-Type to application/json by default. Strange enough, it allows changing the default type by passing MediaTypeHeaderValue argument.

You can also define JsonSerialization options etc.

The code should look something like this:

var content = JsonContent.Create(new {someData = "data"}, options: new JsonSerializerOptions {PropertyNamingPolicy = JsonNamingPolicy.CamelCase}); 

or simply:

var content = JsonContent.Create(new {someData = "data"}); 

if you don't need serializer options or different content type.

For those wanting to set the Content-Type to Json specifically, you can use the extension method PostAsJsonAsync.

using System.Net.Http.Json; //this is needed for PostAsJsonAsync to work //.... HttpClient client = new HttpClient(); HttpResponseMessage response = await client.PostAsJsonAsync("http://example.com/" + "relativeAddress", new { name = "John Doe", age = 33 }); //Do what you need to do with your response 

The advantage here is cleaner code and you get to avoid stringified json. More details can be found at: https://learn.microsoft.com/en-us/previous-versions/aspnet/hh944339(v=vs.118)

Setting the content type (my case I'm setting "application/vnd.api+json") like this worked for me:

var requestBody = new StringContent("{"data": "1"}"), new MediaTypeHeaderValue("application/vnd.api+json")); var response = await _httpClient.PostAsync(apiUrl, requestBody); 

You need to do it like this:

 HttpContent httpContent = new StringContent(@"{ the json string }"); httpContent.Headers.ContentType = new MediaTypeHeaderValue("application/json"); client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json")); HttpResponseMessage message = client.PostAsync(@"{url}", httpContent).Result; 

For my scenario, a third-party API was creating the HttpRequestMessage, so I was not able to use the top-voted answers to resolve the issue. And I didn't like the idea of messing with reflection so the other answers didn't work either.

Instead, I extended from AndroidMessageHandler and used this new class as a parameter to HttpClient. AndroidMessageHandler contains the method SendAsync which can be overridden in order to make changes to the HttpRequestMessage object before it is sent. If you don't have access to the Android Xamarin libaries, you may be able to figure something out with HttpMessageHandler.

public class XamarinHttpMessageHandler : global::Xamarin.Android.Net.AndroidMessageHandler { protected override Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken) { // Here I make check that I'm only modifying a specific request // and not all of them. if (request.RequestUri != null && request.RequestUri.AbsolutePath.EndsWith("download") && request.Content != null) { request.Content.Headers.Add("Content-Type", "text/plain"); } return base.SendAsync(request, cancellationToken); } } 

Then to use:

var client = new HttpClient(new XamarinHttpMessageHandler()); 

I find it most simple and easy to understand in the following way:

async Task SendPostRequest() { HttpClient client = new HttpClient(); var requestContent = new StringContent(<content>); requestContent.Headers.ContentType = new MediaTypeHeaderValue("application/json"); var response = await client.PostAsync(<url>, requestContent); var responseString = await response.Content.ReadAsStringAsync(); } ... SendPostRequest().Wait(); 

Api returned

"Unsupported Media Type","status":415

Adding ContentType to the jsonstring did the magic and this is my script working 100% as of today

 using (var client = new HttpClient()) { var endpoint = "api/endpoint; var userName = "xxxxxxxxxx"; var passwd = "xxxxxxxxxx"; var content = new StringContent(jsonString, Encoding.UTF8, "application/json"); var authToken = Encoding.ASCII.GetBytes($"{userName}:{passwd}"); client.BaseAddress = new Uri("https://example.com/"); client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", Convert.ToBase64String(authToken)); HttpResponseMessage response = await client.PostAsync(endpoint, content); if (response.IsSuccessStatusCode) { // Get the URI of the created resource. Uri returnUrl = response.Headers.Location; Console.WriteLine(returnUrl); } string responseBody = await response.Content.ReadAsStringAsync(); return responseBody; } 

So if you're trying to do a /$batch OData request like this Microsoft article demonstrates where you're supposed to have a Content-Type header like:

Content-Type: multipart/mixed;boundary=batch_d3bcb804-ee77-4921-9a45-761f98d32029

string headerValue = "multipart/mixed;boundary=batch_d3bcb804-ee77-4921-9a45-761f98d32029"; //You need to set it like thus: request.Content.Headers.ContentType = MediaTypeHeaderValue.Parse(headerValue); 

Again, the magic you need is: MediaTypeHeaderValue.Parse(...)

If you REALLY need to override the Content-Type heading, this works in .net 8.0

var content = new StringContent(data); content.Headers.Remove("Content-Type"); content.Headers.TryAddWithoutValidation("Content-Type","multipart/form-data; boundary=K4hA0G9DSJ5VCtP4FmAcrgymeaMHpJ0I3K"); 

(I really needed complete control over the outgoing body in POST to track down a weird error)