This documentation is for WSO2 Enterprise Integrator version 6.1.1 . View documentation for the latest release in the 6.x.x family and the latest release in the 7.x.x family.

All docs This doc

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


The parameters available to configure the Header mediator are as follows.

Paramater NameDescription
NameThe name of the header element. You can specify the namespace used in the header element by clicking the Namespaces link next to the text field.
ActionSelect Set if you want to set the header as a new header. Select Remove if you want to remove the header from the incoming message.
Value/ExpressionA static value or an XPath expression that will be executed on the message to set the header value.
Inline XML Header

This parameter allows you to directly input any XML syntax related to the Header mediator (specifically for SOAP headers). For example, to achieve the following configuration, you should enter the lastTradeTimestamp element in the Inline XML Header parameter.

Code Block
   <urn:lastTradeTimestamp xmlns:urn=" ">Mon May 13 13:52:17 IST 2013</urn:lastTradeTimestamp>  
 ScopeSelect Synapse if you want to manipulate SOAP headers. Select Transport if you want to manipulate HTTP headers.
 NamespacesYou can click this link to
add namespaces if
add namespaces if you are providing an expression. The Namespace Editor panel would appear. You can enter any number of namespace prefixes and URL that you have used in the XPath expression in this panel.

You can also configure the Mediator using XML. Click switch to source view in the Mediator window.


In the following example, the value for P1 code should be included in the SOAP header of the message sent from the client to the EI the ESB profile. To do this, the header mediator is added to the in sequence of the proxy configuration as shown below. 


The following example makes the EI add the ESB profile add the HTTP header Accept with the value image/jpeg to the HTTP request made to the endpoint.