hi-events-webhook-testing

Hi.Events Webhook E2E Testing

How to test the Guild ↔ Hi.Events webhook integration locally using a sandbox organizer.

Prerequisites

• Hi.Events sandbox organizer set up
• Guild running locally (pnpm dev)
• Tailscale funnel available
• A Guild member in Payload whose email matches the Hi.Events attendee email

Steps

1. Expose local server

tailscale funnel 3000

Endpoint: https://kurose.jacob-climb.ts.net/api/webhooks/hi-events

2. Create webhook in Hi.Events

Organizer dashboard → Integrations → Create Webhook:

• URL: https://kurose.jacob-climb.ts.net/api/webhooks/hi-events
• Events: checkin.created, order.created
• Copy the signing secret

3. Set env var

Add the signing secret to .env:

HI_EVENTS_WEBHOOK_SECRET=<secret from step 2>

Restart pnpm dev.

4. Seed a matching member

Create a member in Payload admin (/admin/collections/members) with the same email you’ll use to register in Hi.Events.

5. Create free event + register

In Hi.Events:

1. Create a free event with a free ticket
2. Register using the same email as the Guild member

Check terminal for: Hi.Events order linked for member X

6. Check in the attendee

In Hi.Events: event → Check-in Lists → check in the attendee.

Check terminal for: Hi.Events check-in for member X

7. Verify in Payload admin

• /admin/collections/check-ins — new record with method event
• /admin/collections/members — hiEventsAttendeeId should be populated

Debugging

• Check pnpm dev terminal for signature errors or processing logs
• Hi.Events: organizer → Integrations → click webhook → Logs (shows response codes and payloads sent)