Skip to main content

HighLevel AI Agent Contest 2025: Getting Started Guide

Audience: AI Agent Contest participants building Conversation AI or Voice AI agents and publishing them as Marketplace templates.

Outcome: By the end of this guide, you’ll have a working agent (chat or voice), packaged as a reusable template, and a Marketplace listing ready for review and installation.


Watch Demo

Prerequisites

  • A HighLevel Agency account. If you do not have a HighLevel agency account, you can create one by signing up on Marketplace Portal. Once logged in, head to the Testing tab to create a sandbox account.

  • Role: If you're using an existing HighLevel account, you must be an Agency Owner or Admin to create Marketplace listings.

  • Developer Portal: You must be signed in to (marketplace.gohighlevel.com) for listing the agent on the marketplace.

  • A clear use case (e.g., lead qualification, appointment booking, call routing, support triage).


Step 1 — Design your agent

  • Define the job-to-be-done. “Who does this agent help, and how do we measure success?”
  • Map the interaction. Draft happy path + recovery paths (fallback, transfer to human, re-ask, escalate).
  • List required assets. Workflows, calendars, custom fields/values, tags, custom fields, etc.
  • Guardrails & tone. Style, compliance boundaries, PII handling, and off-topic responses.

Pro tip: Draft 6–10 suggested questions you’ll later add to the Marketplace listing so buyers can try-before-install (for chat agents).


Step 2 — Build in HighLevel

Choose your channel and configure essentials:

Creating Conversation AI Agents (chat & messaging)

Creating Voice AI Agents (phone)


New to prompt writing? Check out Prompting 101 for tips on crafting effective prompts.


Step 3 — Test like a buyer

  • Conversation AI: Run end‑to‑end chats with your suggested questions. Verify outputs, field mapping, workflow triggers, and error messages.
  • Voice AI: Place test calls from multiple devices; review call history (transcript, audio, summary), tune prompts, and confirm transfers/appointments.
  • Edge cases: no‑show calendars, invalid emails, multi‑turn clarifications, rate limits.

Go/No‑Go checklist

  • Agent completes the core task unaided 3× in a row
  • Recovery paths work (re-ask, escalate, or handoff)
  • Workflows, calendars, and custom fields update correctly
  • Clear user feedback on failures + safe fallbacks

Step 4 — Package as a Template and Sell on Marketplace

  • Convert your single agent or multi‑agent team into a reusable template.
  • In Conversation AI or Voice AI, choose your agent/template and select Sell this Template/Agent on Marketplace.
  • You’ll be redirected to the Developer Portal with a special link representing your package.
  • To update an existing listing later, copy the new Marketplace link from the agent and update it in the Developer Portal.
  • Ensure the template includes its underlying assets (workflows, calendars, custom fields/values, etc.).
  • Do not include restricted assets from IP‑protected snapshots.

Cataloging guidance

  • Title: Clear outcome + audience. Example: “Dental Lead Qualifier & Scheduler (Chat + Voice)”
  • Fill Use cases, Agent description, Available actions (workflows, appointments, transfers, etc.).
  • Add Suggested questions buyers can try in the Marketplace preview (for chat agents).
  • Review non‑editable channels (SMS, email, Instagram, calls) and confirm accuracy.

Step 5 — Complete App Details in the Developer Portal

Listing polish tips

  • Navigate to Profile > App Profile page to catalog your agent effectively.
  • Lead with the outcome and who benefits.
  • Show videos/screenshots/gifs of the agent in action + first‑run checklist.

Step 6 — Pricing

Make sure to keep your agent free to be eligible for the Contest duration. For detailed steps, see the App Pricing Setup Guide.


Step 7 — Finalize & Submit for review

  • Complete Basic Info, App Profile, Pricing, and Support sections.
  • Submit for Marketplace review. Once approved, your listing goes live.