Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt

Use this file to discover all available pages before exploring further.

Hosted Pages let you publish your agent on a dedicated URL at gumloopagents.com. Instead of sharing access to the Gumloop builder, you give people a clean, focused chat interface where they can interact with your agent directly.

Dedicated URL

Each agent gets its own your-agent.gumloopagents.com link that people can bookmark and open directly.

Focused Chat Surface

People use the agent from a standalone chat page instead of navigating through the Gumloop builder.

No Separate App Needed

The hosted page uses the same agent instructions and tools you already configured in Gumloop.

Control Access Anytime

Update the URL alias or disable the hosted page whenever you want.

​
Setting Up a Hosted Page

1

Open the Hosted Page Channel

Navigate to your agent, then click Hosted Page under External Channels in the sidebar.
External Channels sidebar showing Email, Slack, Microsoft Teams, and Hosted Page options
You’ll see a page describing the feature and its benefits.
Hosted Page setup page showing benefits and Enable Hosted Page button
2

Enable the Hosted Page

Click Enable Hosted Page. Gumloop automatically generates a URL alias based on your agent’s name. The alias follows the format:
your-agent-name.gumloopagents.com
You can copy the URL using the copy button, or click the pencil icon to customize the alias.
3

Share the Link

Share the hosted page URL with anyone who needs to use the agent. When they open the link, they’ll see a standalone chat interface with your agent’s name and icon.
Hosted page chat interface showing the agent name, tools, and message input

​
Customizing the URL Alias

You can change the hosted page alias at any time:
  1. Click the pencil icon next to the current URL
  2. Type your desired alias (3-64 characters, lowercase letters, numbers, and hyphens only)
  3. Press Enter or click the checkmark to save
The alias must be unique across all Gumloop agents. If the alias you want is already taken, you’ll need to choose a different one.
Certain aliases like admin, api, app, auth, docs, support, and www are reserved and cannot be used.

​
Authentication and Sign-In

Hosted pages require users to sign in before they can chat with the agent. Here’s how the authentication flow works:
  1. A visitor opens the hosted page URL (e.g., your-agent.gumloopagents.com)
  2. The page resolves the agent alias and loads the agent’s profile (name, icon, tools)
  3. The visitor is prompted to sign in through Gumloop’s authentication
  4. After signing in, a secure one-time session token is exchanged, and the visitor is redirected back to the hosted page with full chat access
The sign-in session is scoped to the hosted page domain. Authentication uses a secure broker flow where credentials never pass through the hosted subdomain directly.

​
Permissions and Access

Hosted pages use the same permission system as the rest of Gumloop:
Permission LevelWhat They Can Do
Owner / EditorChat with the agent, enable/disable the hosted page, change the alias
Use-OnlyChat with the agent through the hosted page
ViewerCannot access the hosted page
The hosted page interface automatically hides features that aren’t relevant for the surface:
  • No configuration panel: Users cannot see or modify agent settings from the hosted page
  • No external channel management: The sidebar for Email, Slack, and other channels is hidden
  • No app-level navigation: The hosted page doesn’t show the Gumloop builder navigation
Only users with Editor or Owner access (and the manage_hosting permission) can enable, disable, or modify the hosted page configuration. Organization administrators can also restrict hosted pages through App Rules if needed.
Hosted Pages is a Pro feature. Free-tier users will see an upgrade prompt when attempting to enable a hosted page.

​
Credits and Billing

Conversations on hosted pages consume credits the same way as regular agent chats in the Gumloop builder. The credit cost depends on:
  • AI model usage: Token consumption based on the model your agent uses
  • Tool calls: Each MCP integration or workflow execution costs credits
  • Conversation length: Longer conversations with more context use more tokens
Credits are charged to the agent owner’s account (or the organization, for team agents), not to the person chatting on the hosted page. This means you control the budget, and your users don’t need to worry about credit balances.
Monitor your agent’s credit usage from the Credits page. If you’re sharing hosted pages widely, consider setting up credit alerts to avoid unexpected charges.

​
Credentials and Integrations

When someone interacts with your agent through a hosted page, the agent uses the credentials configured by the agent owner. This means:
  • MCP integrations (Gmail, Slack, Salesforce, etc.) use the owner’s connected accounts
  • Workflows run with the owner’s permissions and credentials
  • API keys (BYOK or platform-provided) are the owner’s keys
Hosted page users do not need to connect their own integrations. The agent operates with the same tools and access it has when you use it directly in the Gumloop builder.
Be mindful of what integrations your agent has access to before sharing its hosted page widely. If your agent can send emails or modify data in external systems, anyone with access to the hosted page can trigger those actions through conversation.

​
Disabling a Hosted Page

To disable a hosted page:
  1. Navigate to the Hosted Page channel in your agent’s sidebar
  2. Click Disable Hosted Page in the status section
Disabling the hosted page immediately makes the URL inaccessible. The alias reservation is preserved, so if you re-enable later, you can use the same alias (unless it’s been claimed by another agent in the meantime).

​
FAQ

Hosted pages are currently served on the gumloopagents.com domain only. Custom domains are not supported at this time.
Yes. Users must sign in through Gumloop authentication to access a hosted page. This ensures secure access and proper credit tracking.
Access is controlled through Gumloop’s standard sharing and permissions system. Only users you’ve shared the agent with (at Use-Only level or above) can use the hosted page. Organization admins can also restrict hosted pages entirely via App Rules.
Changing the alias updates the URL. Existing conversations are preserved in the agent’s chat history and remain accessible to users who sign in again on the new URL.
Yes. The hosted page is a responsive web interface that works on mobile browsers. Users can open the URL on any device and interact with the agent.
Hosted pages are designed to be opened as standalone pages at their gumloopagents.com URL. Embedding via iframe is not officially supported. If you need to embed an agent in your own site, consider using the Gumloop API to build a custom integration.
Credits are charged to the agent owner’s account (or the organization for team agents). People chatting on the hosted page do not need their own credit balance.
Sharing an agent gives someone access through the Gumloop builder, where they see the full navigation, configuration options, and other workbooks. A hosted page provides a standalone, distraction-free chat surface at a dedicated URL. Use hosted pages when you want people to interact with your agent without needing to navigate the Gumloop platform.