Integrations

1. Environment

• Copy .env.example values into your deployment: DATABASE_URL, GHL_APP_CLIENT_ID, GHL_APP_CLIENT_SECRET, GHL_APP_REDIRECT_URI (must match this callback exactly), and GHL_TOKEN_ENCRYPTION_KEY.
• Run the SQL in drizzle/0000_init.sql on your Postgres database (or npx drizzle-kit push).

2. Redirect URL

In the Marketplace app Auth settings, add this Redirect / Callback URL:

https://j-view.vercel.app/api/oauth/callback

3. Install the app

Add NEXT_PUBLIC_GHL_INSTALL_URL (Installation URL from GHL), then click below.

4. Custom Page URL

Create a Custom Page in your marketplace app that points at the embed route. Use HighLevel URL variables so each contact loads correctly.

Location install (typical)

https://j-view.vercel.app/embed/contact?location_id={{location.id}}&contact_id={{contact.id}}

Agency (Company) install — pass company id if HighLevel exposes it for your placement

https://j-view.vercel.app/embed/contact?location_id={{location.id}}&contact_id={{contact.id}}&company_id={{location.companyId}}

Confirm supported URL variables in the current HighLevel Custom Pages documentation; placeholders above follow the usual {{location.id}} style.