A bucket domain is the Repost host your webhook provider calls. The host identifies which bucket receives the request, and the path after the host is preserved on every event Repost records. Understanding how domains and labels work helps you configure providers correctly and avoid routing gaps when you rename or reorganize buckets.
How the domain is structured#
The Repost dashboard splits each bucket endpoint into two parts: an editable label that you control, and a fixed base domain that Repost manages. The full endpoint your provider calls is the label joined to the base domain.
The prefix you set and can change. For example, stripe-prod. This is what makes each bucket's URL unique and recognizable.
The Repost-managed suffix appended to your label. It never changes: you cannot edit or replace it with a custom domain today.
If your label is stripe-prod, the full bucket host displayed in the dashboard is stripe-prod.<base-domain>. If the provider also requires a specific path, append it after the host, for example https://stripe-prod.<base-domain>/webhooks/stripe.
Custom domains are listed in the Domains settings page as an upcoming capability. Generated Repost domains are the configurable endpoint available today.
Bucket name vs. endpoint label#
The bucket name and the endpoint label are separate fields that serve different purposes. Changing one does not automatically change the other.
Used for dashboard identity: it appears in the sidebar, history, and settings. Renaming a bucket updates its internal slug but does not change the provider-facing endpoint URL.
Used for incoming webhook routing. Changing the label changes the URL your provider must call. The bucket name is unaffected.
The bucket domain is determined by the endpoint label, not the bucket name. Renaming your bucket in settings does not update the URL your provider is calling. Update the endpoint label under Domains if you need to change the provider-facing URL.
How paths are preserved#
When a provider calls your bucket URL with a path, for example https://stripe-prod.<base-domain>/webhooks/v2/events, Repost preserves the full path on the recorded event.
The path your provider sends is attached to the event record and forwarded to destinations that use transparent mode. Your application receives the same path the provider sent.
When a forwarder uses locked path mode, the destination URL path is fixed regardless of what the provider sent. The event still records the original path.
If your provider supports configuring a webhook URL with a path, use a meaningful path such as /webhooks/stripe to make event history easier to filter and read.
Change the endpoint label#
You can change the endpoint label at any time from the bucket's Domains settings page. Repost validates the new label before saving.
Navigate to the bucket in the dashboard, go to Settings, and select the Domains section.
Type the label you want to use. The dashboard lowercases letters and strips dots as you type. Other invalid characters place the form in an error state.
Repost checks whether the full generated domain is available. The Save button stays disabled until the check passes. If the label is taken, try a more specific value.
After saving, the old URL stops accepting traffic immediately. Update the webhook URL in your provider's settings before the next event is sent.
Changing the endpoint label takes effect immediately. There is no grace period: the old URL stops working as soon as you save. Update your provider's webhook configuration before making this change in production.
Valid endpoint labels#
Labels follow DNS-safe rules so the generated endpoint can be routed reliably.
Allowed characters
Lowercase letters (a–z), numbers (0–9), and hyphens (-). Uppercase letters and dots are not allowed. The dashboard lowercases and removes dots automatically as you type.
Length
The label must be between 1 and 63 characters long.
Edge rules
The label cannot start or end with a hyphen. For example, -stripe and stripe- are invalid; stripe-prod is valid.
stripe-prod
github-events
webhook01
clerk-productionStripeProd (uppercase letters)
stripe.prod (contains a dot)
-stripe (starts with a hyphen)
stripe- (ends with a hyphen)Use the domain in your provider's webhook settings#
When configuring the webhook URL in your provider's dashboard, whether Stripe, GitHub, Clerk, or any other service, copy the full generated domain from the Repost bucket Domains page. Use the complete URL including any path your integration requires.
Use https://stripe-prod.<base-domain> when the provider sends all event types to a single URL and your forwarder handles path routing.
Use https://stripe-prod.<base-domain>/webhooks/stripe when your application expects events at a specific path, or when you want to make event history easier to filter.
Related pages#
Configure the acknowledgement or proxy timeout that providers receive when they call the bucket URL.
Review and update identity, status, response behavior, domains, and deletion guardrails.
Confirm provider calls are arriving at the correct bucket after an endpoint change.