# gohighlevel-wasp-drone

gohighlevel-wasp-drone is a Claude Code subagent for GoHighLevel API integrations. It selects OAuth or a private token, handles contacts and lead upserts, verifies webhook signatures, and prepares Marketplace apps.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 96 repo stars
- Author: Legion Code Inc.
- License: AGPL-3.0-or-later · policy=link-only · description only; the file stays with the author
- Source: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/highlevel/agents/gohighlevel-wasp-drone.md
- Updated: 2026-10-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/gohighlevel-wasp-drone

## What it does

This subagent owns the shape of a GoHighLevel integration: auth method selection, token scope (Agency vs Location), contact upsert logic to prevent duplicates, webhook signature verification, and Marketplace app distribution. It knows when to reach for Private Integration Token (single internal tool) versus OAuth 2.0 (distributable app).

Guides inside cover resources (contacts, opportunities, pipelines, calendars, conversations), request shapes, inbound and outbound webhook handling with `X-GHL-Signature` verification, and Marketplace checklist. Runs in Claude Code and Codex with tools for code reading, search, editing, and web requests.

Stays out of AI Studio, general OAuth provider selection, and security audit of existing integrations — those are other agents' scope.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add legioncodeinc/vibe-coding-tools
```
In the agent chat (not a shell):
```text
/plugin install highlevel@wasp-nest
```

2. **Manually: put the files in place**
- File: `.claude/agents/gohighlevel-wasp-drone.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/gohighlevel-wasp-drone.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/gohighlevel-wasp-drone.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/highlevel/agents/gohighlevel-wasp-drone.md

## When to use it
- decide between OAuth and private token for your setup
- sync leads and contacts without creating duplicates
- build a webhook handler that verifies signatures and survives retries
- create and publish an app to GoHighLevel Marketplace

## Example prompts
- Set up GoHighLevel OAuth and show me where to store the token securely
- Build a handler for an inbound GoHighLevel webhook and verify its signature
- Design a contact upsert pattern that avoids duplicates on repeated syncs

## Similar
- [gohighlevel](https://affpapa.org/en/nevibecode/skills/membrane-gohighlevel.md) — skill · 272 installs
- [build-zoom-phone-integration](https://affpapa.org/en/nevibecode/skills/anthropics-build-zoom-phone-integration.md) — skill · 2200 installs
- [track17](https://affpapa.org/en/nevibecode/skills/track17.md) — skill · 104 installs
- [lead-routing](https://affpapa.org/en/nevibecode/skills/claude-office-skills-lead-routing.md) — skill · 4700 installs
- [Anthony Hunt · SHAART Agency](https://affpapa.org/en/nevibecode/mcp/anthony-hunt-shaart-agency.md) — MCP server
- [persona](https://affpapa.org/en/nevibecode/skills/membrane-persona.md) — skill · 166 installs

From the same set: [legioncodeinc/vibe-coding-tools](https://affpapa.org/en/nevibecode/by/legioncodeinc/vibe-coding-tools.md) — 172 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
