--- title: Create Spectrum application using a name for the origin --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Spectrum](https://developers.cloudflare.com/api/go/resources/spectrum) [Apps](https://developers.cloudflare.com/api/go/resources/spectrum/subresources/apps) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create Spectrum application using a name for the origin client.Spectrum.Apps.New(ctx, params) (\*[AppNewResponse](), error) POST/zones/{zone\_id}/spectrum/apps Creates a new Spectrum application from a configuration using a name for the origin. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `Zone Settings Write` ##### ParametersExpand Collapse
params AppNewParams ZoneID param.Field\[string] Path param: Zone identifier. maxLength32 Link to this property DNS param.Field\[DNS] Body param: The name and type of DNS record for the Spectrum application. Link to this property Protocol param.Field\[string] Body param: The port configuration at Cloudflare’s edge. May specify a single port, for example "tcp/1000", or a range of ports, for example "tcp/1000-2000". Link to this property
TrafficType param.Field\[AppNewParamsSpectrumConfigAppConfigTrafficType] Body param: Determines how data travels from the edge to your origin. When set to “direct”, Spectrum will send traffic directly to your origin, and the application’s type is derived from the protocol. When set to “http” or “https”, Spectrum will apply Cloudflare’s HTTP/HTTPS features as it sends traffic to your origin, and the application type matches this property exactly. When set to “worker”, traffic is sent to the Worker specified by origin_worker_id. const AppNewParamsSpectrumConfigAppConfigTrafficTypeDirect AppNewParamsSpectrumConfigAppConfigTrafficType = "direct" Link to this property const AppNewParamsSpectrumConfigAppConfigTrafficTypeHTTP AppNewParamsSpectrumConfigAppConfigTrafficType = "http" Link to this property const AppNewParamsSpectrumConfigAppConfigTrafficTypeHTTPS AppNewParamsSpectrumConfigAppConfigTrafficType = "https" Link to this property const AppNewParamsSpectrumConfigAppConfigTrafficTypeWorker AppNewParamsSpectrumConfigAppConfigTrafficType = "worker" Link to this property
Link to this property ArgoSmartRouting param.Field\[bool]Optional Body param: Enables Argo Smart Routing for this application. Notes: Only available for TCP or UDP applications with traffic\_type set to “direct”. Link to this property EdgeIPs param.Field\[EdgeIPs]Optional Body param: The anycast edge IP configuration for the hostname of this application. Link to this property IPFirewall param.Field\[bool]Optional Body param: Enables IP Access Rules for this application. Notes: Only available for TCP applications. Link to this property OriginDirect param.Field\[\[]string]Optional Body param: List of origin IP addresses. Array may contain multiple IP addresses for load balancing. Link to this property OriginDNS param.Field\[OriginDNS]Optional Body param: The name and type of DNS record for the Spectrum application. Link to this property OriginPort param.Field\[OriginPortUnion]Optional Body param: The destination port at the origin. Only specified in conjunction with origin\_dns. May use an integer to specify a single origin port, for example 1000, or a string to specify a range of origin ports, for example "1000-2000". Notes: If specifying a port range, the number of ports in the range must match the number of ports specified in the “protocol” field. maximum65535 minimum1 Link to this property OriginWorkerID param.Field\[string]Optional Body param: Optional Worker script tag (worker ID) to use as the application’s origin. Only supported for TCP applications with traffic\_type “worker”; mutually exclusive with origin\_direct, origin\_dns, origin\_port, proxy\_protocol, and argo\_smart\_routing. tls may only be “off” or “flexible”. Link to this property
ProxyProtocol param.Field\[AppNewParamsSpectrumConfigAppConfigProxyProtocol]Optional Body param: Enables Proxy Protocol to the origin. Refer to Enable Proxy protocol for implementation details on PROXY Protocol V1, PROXY Protocol V2, and Simple Proxy Protocol. const AppNewParamsSpectrumConfigAppConfigProxyProtocolOff AppNewParamsSpectrumConfigAppConfigProxyProtocol = "off" Link to this property const AppNewParamsSpectrumConfigAppConfigProxyProtocolV1 AppNewParamsSpectrumConfigAppConfigProxyProtocol = "v1" Link to this property const AppNewParamsSpectrumConfigAppConfigProxyProtocolV2 AppNewParamsSpectrumConfigAppConfigProxyProtocol = "v2" Link to this property const AppNewParamsSpectrumConfigAppConfigProxyProtocolSimple AppNewParamsSpectrumConfigAppConfigProxyProtocol = "simple" Link to this property
Link to this property
TLS param.Field\[AppNewParamsSpectrumConfigAppConfigTLS]Optional Body param: The type of TLS termination associated with the application. const AppNewParamsSpectrumConfigAppConfigTLSOff AppNewParamsSpectrumConfigAppConfigTLS = "off" Link to this property const AppNewParamsSpectrumConfigAppConfigTLSFlexible AppNewParamsSpectrumConfigAppConfigTLS = "flexible" Link to this property const AppNewParamsSpectrumConfigAppConfigTLSFull AppNewParamsSpectrumConfigAppConfigTLS = "full" Link to this property const AppNewParamsSpectrumConfigAppConfigTLSStrict AppNewParamsSpectrumConfigAppConfigTLS = "strict" Link to this property
Link to this property VirtualNetworkID param.Field\[string]Optional Body param: Optional UUID of a virtual network for routing origin traffic through tunnel virtual networks. formatuuid Link to this property
[Link to this property](<#(resource)%20spectrum.apps%20%3E%20(method)%20create%20%3E%20(params)%200>) ##### ReturnsExpand Collapse
type AppNewResponse interface{…} One of the following:
type AppNewResponseSpectrumConfigAppConfig struct{…} ID string App identifier. maxLength32 Link to this property CreatedOn Time When the Application was created. formatdate-time Link to this property
DNS DNS The name and type of DNS record for the Spectrum application. Name stringOptional The name of the DNS record associated with the application. formathostname Link to this property
Type DNSTypeOptional The type of DNS record associated with the application. One of the following: const DNSTypeCNAME DNSType = "CNAME" Link to this property const DNSTypeAddress DNSType = "ADDRESS" Link to this property
Link to this property
Link to this property ModifiedOn Time When the Application was last modified. formatdate-time Link to this property Protocol string The port configuration at Cloudflare’s edge. May specify a single port, for example "tcp/1000", or a range of ports, for example "tcp/1000-2000". Link to this property
TrafficType AppNewResponseSpectrumConfigAppConfigTrafficType Determines how data travels from the edge to your origin. When set to “direct”, Spectrum will send traffic directly to your origin, and the application’s type is derived from the protocol. When set to “http” or “https”, Spectrum will apply Cloudflare’s HTTP/HTTPS features as it sends traffic to your origin, and the application type matches this property exactly. When set to “worker”, traffic is sent to the Worker specified by origin_worker_id. One of the following: const AppNewResponseSpectrumConfigAppConfigTrafficTypeDirect AppNewResponseSpectrumConfigAppConfigTrafficType = "direct" Link to this property const AppNewResponseSpectrumConfigAppConfigTrafficTypeHTTP AppNewResponseSpectrumConfigAppConfigTrafficType = "http" Link to this property const AppNewResponseSpectrumConfigAppConfigTrafficTypeHTTPS AppNewResponseSpectrumConfigAppConfigTrafficType = "https" Link to this property const AppNewResponseSpectrumConfigAppConfigTrafficTypeWorker AppNewResponseSpectrumConfigAppConfigTrafficType = "worker" Link to this property
Link to this property ArgoSmartRouting boolOptional Enables Argo Smart Routing for this application. Notes: Only available for TCP or UDP applications with traffic\_type set to “direct”. Link to this property
EdgeIPs EdgeIPsOptional The anycast edge IP configuration for the hostname of this application. One of the following:
type EdgeIPsDynamic struct{…}
Connectivity EdgeIPsDynamicConnectivityOptional The IP versions supported for inbound connections on Spectrum anycast IPs. One of the following: const EdgeIPsDynamicConnectivityAll EdgeIPsDynamicConnectivity = "all" Link to this property const EdgeIPsDynamicConnectivityIPV4 EdgeIPsDynamicConnectivity = "ipv4" Link to this property const EdgeIPsDynamicConnectivityIPV6 EdgeIPsDynamicConnectivity = "ipv6" Link to this property
Link to this property Type EdgeIPsDynamicTypeOptional The type of edge IP configuration specified. Dynamically allocated edge IPs use Spectrum anycast IPs in accordance with the connectivity you specify. Only valid with CNAME DNS names. Link to this property
Link to this property
type EdgeIPsStatic struct{…} IPs \[]stringOptional The array of customer owned IPs we broadcast via anycast for this hostname and application. Link to this property Type EdgeIPsStaticTypeOptional The type of edge IP configuration specified. Statically allocated edge IPs use customer IPs in accordance with the ips array you specify. Only valid with ADDRESS DNS names. Link to this property
Link to this property
Link to this property IPFirewall boolOptional Enables IP Access Rules for this application. Notes: Only available for TCP applications. Link to this property OriginDirect \[]stringOptional List of origin IP addresses. Array may contain multiple IP addresses for load balancing. Link to this property
OriginDNS OriginDNSOptional The name and type of DNS record for the Spectrum application. Name stringOptional The name of the DNS record associated with the origin. formathostname Link to this property TTL int64Optional The TTL of our resolution of your DNS record in seconds. minimum600 Link to this property
Type OriginDNSTypeOptional The type of DNS record associated with the origin. "" is used to specify a combination of A/AAAA records. One of the following: const OriginDNSTypeEmpty OriginDNSType = "" Link to this property const OriginDNSTypeA OriginDNSType = "A" Link to this property const OriginDNSTypeAAAA OriginDNSType = "AAAA" Link to this property const OriginDNSTypeSRV OriginDNSType = "SRV" Link to this property
Link to this property
Link to this property
OriginPort OriginPortUnionOptional The destination port at the origin. Only specified in conjunction with origin\_dns. May use an integer to specify a single origin port, for example 1000, or a string to specify a range of origin ports, for example "1000-2000". Notes: If specifying a port range, the number of ports in the range must match the number of ports specified in the “protocol” field. maximum65535 minimum1 One of the following: UnionInt Link to this property UnionString Link to this property
Link to this property OriginWorkerID stringOptional Optional Worker script tag (worker ID) to use as the application’s origin. Only supported for TCP applications with traffic\_type “worker”; mutually exclusive with origin\_direct, origin\_dns, origin\_port, proxy\_protocol, and argo\_smart\_routing. tls may only be “off” or “flexible”. Link to this property
ProxyProtocol AppNewResponseSpectrumConfigAppConfigProxyProtocolOptional Enables Proxy Protocol to the origin. Refer to Enable Proxy protocol for implementation details on PROXY Protocol V1, PROXY Protocol V2, and Simple Proxy Protocol. One of the following: const AppNewResponseSpectrumConfigAppConfigProxyProtocolOff AppNewResponseSpectrumConfigAppConfigProxyProtocol = "off" Link to this property const AppNewResponseSpectrumConfigAppConfigProxyProtocolV1 AppNewResponseSpectrumConfigAppConfigProxyProtocol = "v1" Link to this property const AppNewResponseSpectrumConfigAppConfigProxyProtocolV2 AppNewResponseSpectrumConfigAppConfigProxyProtocol = "v2" Link to this property const AppNewResponseSpectrumConfigAppConfigProxyProtocolSimple AppNewResponseSpectrumConfigAppConfigProxyProtocol = "simple" Link to this property
Link to this property
TLS AppNewResponseSpectrumConfigAppConfigTLSOptional The type of TLS termination associated with the application. One of the following: const AppNewResponseSpectrumConfigAppConfigTLSOff AppNewResponseSpectrumConfigAppConfigTLS = "off" Link to this property const AppNewResponseSpectrumConfigAppConfigTLSFlexible AppNewResponseSpectrumConfigAppConfigTLS = "flexible" Link to this property const AppNewResponseSpectrumConfigAppConfigTLSFull AppNewResponseSpectrumConfigAppConfigTLS = "full" Link to this property const AppNewResponseSpectrumConfigAppConfigTLSStrict AppNewResponseSpectrumConfigAppConfigTLS = "strict" Link to this property
Link to this property VirtualNetworkID stringOptional Optional UUID of a virtual network for routing origin traffic through tunnel virtual networks. formatuuid Link to this property
Link to this property
type AppNewResponseSpectrumConfigPaygoAppConfig struct{…} ID string App identifier. maxLength32 Link to this property CreatedOn Time When the Application was created. formatdate-time Link to this property
DNS DNS The name and type of DNS record for the Spectrum application. Name stringOptional The name of the DNS record associated with the application. formathostname Link to this property
Type DNSTypeOptional The type of DNS record associated with the application. One of the following: const DNSTypeCNAME DNSType = "CNAME" Link to this property const DNSTypeAddress DNSType = "ADDRESS" Link to this property
Link to this property
Link to this property ModifiedOn Time When the Application was last modified. formatdate-time Link to this property Protocol string The port configuration at Cloudflare’s edge. May specify a single port, for example "tcp/1000", or a range of ports, for example "tcp/1000-2000". Link to this property OriginDirect \[]stringOptional List of origin IP addresses. Array may contain multiple IP addresses for load balancing. Link to this property
Link to this property
[Link to this property](<#(resource)%20spectrum.apps%20%3E%20(model)%20AppNewResponse%20%3E%20(schema)>) ### Create Spectrum application using a name for the origin Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/spectrum" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) app, err := client.Spectrum.Apps.New(context.TODO(), spectrum.AppNewParams{ ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), Body: spectrum.AppNewParamsBodySpectrumConfigAppConfig{ DNS: cloudflare.F(spectrum.DNSParam{ }), Protocol: cloudflare.F("tcp/22"), TrafficType: cloudflare.F(spectrum.AppNewParamsBodySpectrumConfigAppConfigTrafficTypeDirect), }, }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", app) } ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2014-01-01T05:20:00.12345Z", "dns": { "name": "ssh.example.com", "type": "CNAME" }, "modified_on": "2014-01-01T05:20:00.12345Z", "protocol": "tcp/22", "traffic_type": "direct", "argo_smart_routing": true, "edge_ips": { "connectivity": "all", "type": "dynamic" }, "ip_firewall": false, "origin_direct": [ "tcp://127.0.0.1:8080" ], "origin_dns": { "name": "origin.example.com", "ttl": 600, "type": "" }, "origin_port": 22, "origin_worker_id": "277b7815c871434b960b60729659000a", "proxy_protocol": "off", "tls": "off", "virtual_network_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e" } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2014-01-01T05:20:00.12345Z", "dns": { "name": "ssh.example.com", "type": "CNAME" }, "modified_on": "2014-01-01T05:20:00.12345Z", "protocol": "tcp/22", "traffic_type": "direct", "argo_smart_routing": true, "edge_ips": { "connectivity": "all", "type": "dynamic" }, "ip_firewall": false, "origin_direct": [ "tcp://127.0.0.1:8080" ], "origin_dns": { "name": "origin.example.com", "ttl": 600, "type": "" }, "origin_port": 22, "origin_worker_id": "277b7815c871434b960b60729659000a", "proxy_protocol": "off", "tls": "off", "virtual_network_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e" } } ```