Custom Domains

HTTP to Flow Agents accommodate inbound HTTP requests to the endpoints that you have defined in a Flow using HTTP-In nodes. By default, HTTP to Flow Agents are accessed via a Contextual-branded base domain (distinct for each Agent), in the following structure:

https://yourAgentId.service/yourTenantId.my.contextual.io/yourFlowEndpointPath

For many solutions, the default base domain that Contextual provides is sufficient, however, some use cases and solutions would benefit from using a fully-branded Custom Domain, rather than the Contextual default. For instance, following this structure:

https://yourDomain.com/yourFlowEndpointPath

Paid Contextual Tenant Subscriptions include the ability to configure a custom domain for one or more HTTP Agents in the tenant.

To add a Custom Domain to your HTTP to Flow Agent...

  1. In your tenant, click Components > Agents in the left-hand navigation menu

  2. Create or choose an existing HTTP to Event Agent

  3. On the Agent Details screen, in the General Section, click "Set Domain"

    Use Your Own Domain on an HTTP to Flow Agent

  4. Follow the instructions provided to create a CNAME record for your domain, within the administrative console of your domain service provider

    1. Copy the Agent Domain value and use it to set up your CNAME with your domain service provider

    2. Enter the domain or subdomain value (e.g. yourdomain.com or subdomain.yourdomain.com) in the field provided

  5. Click Save and Verify

    1. Contextual will attempt to look up and validate the CNAME that you provided

  6. If unsuccessful, you'll be able to retry your CNAME validation by clicking "Retry" or you can remove and enter a new CNAME if needed, at your convenience.

    1. Please be patient, it can take some time for your CNAME record to propagate.

  7. If successful, SSL certificate issuance will begin

    1. Please be patient, it can take some time for SSL certificates to be provisioned

  8. Once your CNAME has been validated and the SSL certificate provisioned, your Custom Domain will be ready for use and you will be able to access any endpoints defined (including a root / path if you have defined one), at the custom domain you have configured:

    1. https://yourDomain.com/yourFlowEndpointPath

Last updated

Was this helpful?