Skip to main content
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.

Editable label

The prefix you set and can change. For example, stripe-prod. This is what makes each bucket’s URL unique and recognizable.

Fixed base domain

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.

Bucket name

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.

Endpoint label

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.

Transparent path pass-through

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.

Path ignored in locked mode

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.
1

Open the Domains settings page

Navigate to the bucket in the dashboard, go to Settings, and select the Domains section.
2

Enter a new label

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.
3

Wait for the availability check

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.
4

Save and update your provider

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.
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.
The label must be between 1 and 63 characters long.
The label cannot start or end with a hyphen. For example, -stripe and stripe- are invalid; stripe-prod is valid.
Valid labels
Invalid labels

​
Use the domain in your provider’s webhook settings

When configuring the webhook URL in your provider’s dashboard — 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.

Host only

Use https://stripe-prod.<base-domain> when the provider sends all event types to a single URL and your forwarder handles path routing.

Host with path

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.

Response behavior

Configure the acknowledgement or proxy timeout that providers receive when they call the bucket URL.

Bucket settings

Review and update identity, status, response behavior, domains, and deletion guardrails.

Event history

Confirm provider calls are arriving at the correct bucket after an endpoint change.