Endpoint Alias

An Endpoint Alias is a shared, org-level DNS name that references an endpoint of a sandbox. Unlike the DNS name of a sandbox endpoint (which encodes the sandbox name and is therefore unique to a specific sandbox), an endpoint alias DNS name does not contain sandbox-specific information. This makes it suitable for use in places that require a deterministic, stable DNS name — such as webhooks registered with external services or OAuth provider callback URLs.

Assigning to a Sandbox

An endpoint alias can be assigned (mapped) to an endpoint of a sandbox, causing traffic sent to the endpoint alias DNS name to be forwarded to that sandbox's endpoint. The assignment can be changed at any time while the external-facing DNS name remains unchanged.

This makes it possible to share a single external service integration with multiple users collaboratively — for example, a webhook URL registered with a third-party service can always point at whichever sandbox is currently being used to develop the integration.

When an endpoint alias is not assigned to a sandbox, it remains unassigned and the DNS name is not accessible.

See Also