# Custom Domains

Beta feature

Custom domains are now available in beta on the Business plan (opens new window).

By default, all new Pipedream HTTP endpoints are hosted on the *.m.pipedream.net domain. But you can configure any domain you want: instead of https://endpoint.m.pipedream.net, the endpoint would be available on https://endpoint.example.com.

# Configuring a new custom domain

# 1. Choose your domain

You can configure any domain you own to work with Pipedream HTTP endpoints. For example, you can host Pipedream HTTP endpoints on a dedicated subdomain on your core domain, like *.eng.example.com or *.marketing.example.com. This can be any domain or subdomain you own.

In this example, endpoints would look like:

[endpoint_id].eng.example.com
[endpoint_id_1].eng.example.com
...

where [endpoint_id] is a uniquely-generated hostname specific to your Pipedream HTTP endpoint.

If you own a domain that you want to completely redirect to Pipedream, you can also configure *.example.com to point to Pipedream. In this example, endpoints would look like:

[endpoint_id].example.com
[endpoint_id_1].example.com
...

Since all traffic on *.example.com points to Pipedream, we can assign hosts on the root domain. This also means that you cannot use other hosts like www.example.com without conflicting with Pipedream endpoints. Choose this option only if you're serving all traffic from example.com from Pipedream.

Before you move on, make sure you have access to manage DNS records for your domain. If you don't, please coordinate with the team at your company that manages DNS records, and feel free to reach out to our Support team (opens new window) with any questions.

# A note on domain wildcards

Note that the records referenced above use the wildcard (*) for the host portion of the domain. When you configure DNS records in step 3, this allows you to point all traffic for a specific domain to Pipedream and create any number of Pipedream HTTP endpoints that will work with your domain.

# 2. Reach out to Pipedream Support

Once you've chosen your domain, reach out to Pipedream Support (opens new window) and let us know what domain you'd like to configure for your workspace. We'll configure a TLS/SSL certificate for that domain, and give you two DNS CNAME records to add for that domain in step 3.

# 3. Add your DNS records

Once we configure your domain, we'll ask you to create two DNS CNAME records:

# Add the CNAME validation record

Pipedream uses AWS Certificate Manager (opens new window) to create the TLS certificate for your domain. To validate the certificate, you need to add a specific DNS recorded provided by Certificate Manager. Pipedream will provide the name and value.

For example, if you requested *.eng.example.com as your custom domain, Pipedream will provide the details of the record, like in this example:

  • Type: CNAME
  • Name: _2kf9s72kjfskjflsdf989234nsd0b.eng.example.com
  • Value: _7ghslkjsdfnc82374kshflasfhlf.vvykbvdtpk.acm-validations.aws.
  • TTL (seconds): 300

Consult the docs for your DNS service for more information on adding CNAME records. Here's an example configuration using AWS's Route53 service:

# Add the DNS CNAME wildcard record

Now you'll need to add the wildcard record that points all traffic for your domain to Pipedream. Pipedream will also provide the details of this record, like in this example:

  • Type: CNAME
  • Name: *.eng.example.com
  • Value: id123.cd.pdrm.net.
  • TTL (seconds): 300

Once you've finished adding these DNS records, please reach out to the Pipedream team. We'll validate the records and finalize the configuration for your domain.

# 4. Send a test request to your custom domain

Any traffic to existing *.m.pipedream.net endpoints will continue to work uninterrupted.

To confirm traffic to your new domain works, take any Pipedream endpoint URL and replace the *.m.pipedream.net with your custom domain. For example, if you configured a custom domain of pipedream.example.com and have an existing endpoint at

https://[endpoint_id].m.pipedream.net

Try making a test request to

https://[endpoint_id].eng.example.com

# Security

# How Pipedream manages the TLS/SSL certificate

See our TLS/SSL security docs for more detail on how we create and manage the certificates for custom domains.

# Requests to custom domains are allowed only for your endpoints

Custom domains are mapped directly to customer endpoints. This means no other customer can send requests to their endpoints on your custom domain. Requests to example.com are restricted specifically to HTTP endpoints in your Pipedream workspace.