--- title: "Creating a custom configuration channel" slug: "creating-a-custom-configuration-channel" updated: 2026-09-08T19:11:41Z published: 2026-09-08T19:11:41Z canonical: "docs.trellix.com/creating-a-custom-configuration-channel" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Creating a custom configuration channel Trellix recommends that you specify *every* configuration file setting (for which you do not want the agent default values) when you create a custom configuration channel. See [Agent Configuration File Reference](/docs/xagent-configuration-file-reference). The only exceptions to this are the values for the `credentials` and `serverlist` sections of the configuration file and the following individual configuration settings: `channel`, `id`, `name`, `ts`, `type`, and `version`. The values for these configuration file settings cannot be specified using custom configuration channels and any attempts to do so will be overridden by the Endpoint Security (HX) API with values established during Endpoint Security (HX) server and agent deployment. **To create a custom configuration channel:** - Use the API to request the custom configuration channel be added. Here is a sample cURL request. `curl 'http://<HX_IP_address>:<port_number>/hx/api/v3/host_policies/channels' -X 'POST' --data-binary '{"name”:”<name>","host_sets":[ {"_id":<host_set_ID1>}, {"_id":<host_set_ID2>},...], "description":"<description>","priority":<priority> configuration: {"<key1>":"<value1>", "<key2>":"<value2>",...}' -H 'X-FeApi-Token: <API_token>' -H 'Accept: application/json' -H 'Content-Type: application/json'` To identify host set IDs, see [Identifying Host Set IDs Using the API](/docs/identifying-host-set-ids-using-the-api). For information about priority settings, see [Understanding Configuration Channel Priorities](/docs/understanding-configuration-channel-priorities). For information about the configuration settings (the key/value pairs in the cURL request above), see [Agent Configuration File Reference](/docs/xagent-configuration-file-reference). For complete information on API custom configuration channel endpoints, see the *Endpoint Security (HX) REST API Guide*. :