First-party app
RegFox

RegFox

Search RegFox (Webconnex) orders, registrants, tickets, transactions, customers and memberships, check attendees in and out, manage coupons and webhooks, and read forms and inventory.

stable Forms & SurveysCommerce & Payments

About

RegFox ships in the w6w first-party pack. It declares 31 actions, 3 health checks, and the host runs its code in a sandbox that never sees the credential.

App id
io.w6w.regfox
Version
0.1.0
Author
w6w
Licence
MIT
Categories
Forms & Surveys · Commerce & Payments

Overview

RegFox is Webconnex’s event-registration product, and the Webconnex API reaches the same account data for its sibling products TicketSpice, RedPodium and GivingFuel. This app lets a workflow look up what happened on a registration form: search and fetch orders, registrants, tickets, transactions, customers, recurring subscriptions and memberships, with every date and id filter the API documents, and expand an order or form to include its children in one call.

On the day of the event it checks a registrant in or out by id or by the display id printed on their ticket. For promotion it creates, reads and deletes coupons (global or form-scoped), and reads a form’s live inventory so a workflow can react to a sell-out. It also manages webhooks, so a registration, publish, coupon or inventory event can start a workflow, and it can read a webhook’s delivery log and resend a delivery that failed.

The API key is sent as an apiKey header. Webhook signing secrets are never returned from list or read actions.

Build with RegFox

Three routes to the same 31 actions. The Workflow tab is generated from RegFox's own manifest and carries its real ids, so it is copy-pasteable; the Code and CLI examples are the same call for any action on any app, so every app-specific value in them is a blank you fill in.

Create Coupon

coupon-create

Create a coupon with one or more codes. Each call creates a new coupon; the vendor accepts no idempotency key.

Delete Coupon

coupon-delete

Delete a coupon and all of its codes. This cannot be undone.

Get Coupon

coupon-get

Get one coupon, with its discounts and codes, by id.

List Form Coupons

coupon-list-form

List the coupons associated with one registration form.

List Global Coupons

coupon-list-global

List the coupons that apply across forms for a Webconnex product.

Get Customer

customer-get

Get one customer by id. The product is required by the vendor.

Search Customers

customer-search

Search Customers for a Webconnex product. Results are cursor-paged: pass the returned `startingAfter` back in while `hasMore` is true.

Get Form

form-get

Get one registration form by id, optionally with its inventory.

Get Form Inventory

form-inventory-get

Get the live inventory (ticket and item supply) of a registration form.

List Forms

form-list

List registration forms, optionally for one Webconnex product, with their status and dates. Statuses: open, closed, scheduled, archived, deleted.

Get Membership

membership-get

Get one membership by id. The product is required by the vendor.

Search Memberships

membership-search

Search Memberships for a Webconnex product. Results are cursor-paged: pass the returned `startingAfter` back in while `hasMore` is true.

Get Order

order-get

Get one order by id. The product is required by the vendor.

Search Orders

order-search

Search Orders for a Webconnex product. Results are cursor-paged: pass the returned `startingAfter` back in while `hasMore` is true.

Check In Registrant

registrant-check-in

Mark a registrant as checked in, by registrant id or by the display id on their ticket. Give exactly one of the two.

Check Out Registrant

registrant-check-out

Mark a registrant as checked out, by registrant id or by the display id on their ticket. Give exactly one of the two.

Get Registrant

registrant-get

Get one registrant by id. The product is required by the vendor.

Search Registrants

registrant-search

Search Registrants for a Webconnex product. Results are cursor-paged: pass the returned `startingAfter` back in while `hasMore` is true.

Get Subscription

subscription-get

Get one subscription by id. The product is required by the vendor.

Search Subscriptions

subscription-search

Search Subscriptions for a Webconnex product. Results are cursor-paged: pass the returned `startingAfter` back in while `hasMore` is true.

Get Ticket

ticket-get

Get one ticket by id. The product is required by the vendor.

Search Tickets

ticket-search

Search Tickets for a Webconnex product. Results are cursor-paged: pass the returned `startingAfter` back in while `hasMore` is true.

Get Transaction

transaction-get

Get one transaction by id. The product is required by the vendor.

Search Transactions

transaction-search

Search Transactions for a Webconnex product. Results are cursor-paged: pass the returned `startingAfter` back in while `hasMore` is true.

Create Webhook

webhook-create

Subscribe a URL to RegFox events. The webhook is created enabled. The response is the one place this app returns the signing secret, because the receiver needs it to verify the `X-Webconnex-Signature` header; store it, do not log it.

Delete Webhook

webhook-delete

Delete a webhook. Its delivery stops immediately.

Get Webhook

webhook-get

Get one webhook by id. The signing secret and legacy token are removed.

List Webhooks

webhook-list

List the account's webhooks. Signing secrets and legacy tokens are removed from the result.

Get Webhook Delivery

webhook-log-get

Get one delivery from a webhook's log, including what was sent and answered.

List Webhook Deliveries

webhook-log-list

List the delivery log of a webhook, to find deliveries your endpoint missed.

Resend Webhook Delivery

webhook-resend

Send a logged webhook delivery to its endpoint again. The signature header is unchanged on a resend, so the receiver sees the original payload and HMAC.

A workflow step names the app and the action, and the editor fills in the connection when you pick one. This is the Step shape from the workflow spec, carrying RegFox's real ids.

{
  "manifestVersion": "2",
  "name": "regfox-example",
  "steps": [
    {
      "id": "coupon-create",
      "uses": {
        "app": "io.w6w.regfox",
        "action": "coupon-create",
        "connection": "conn_YOUR_CONNECTION_ID"
      },
      "with": {
        "name": "<name>",
        "currency": "<currency>",
        "available": "<available>"
      }
    }
  ]
}

Here are some of the things you can do

  • Create Coupon

    perform
    coupon-create
  • Get Coupon

    read
    coupon-get
  • List Form Coupons

    search
    coupon-list-form
  • List Global Coupons

    search
    coupon-list-global
  • Get Customer

    read
    customer-get

+26 more actions available

Every app-specific value here is a blank you have to fill in. An app action is reached through the connection that authenticates it, so the address is a connection id, not the app id — and connections belong to your account, so a public page cannot know yours. Create one for RegFox, then fill in the three blanks: conn_YOUR_CONNECTION_ID, the action key, and the parameters that action declares. The call itself is real — the shape is transcribed from the studio's own snippet builder, which prints the same kind of blanks — but nothing in it is specific to RegFox. The Workflow tab is where this app's real ids are.

Install
npm install @w6w/sdk
yarn add @w6w/sdk
pnpm add @w6w/sdk
deno add npm:@w6w/sdk
Code
import { W6wClient, isActionRun } from "@w6w/sdk";

// Reads W6W_BASE_URL and W6W_TOKEN from the environment when omitted.
const client = new W6wClient();

const envelope = await client.run({
  urn: "conn_YOUR_CONNECTION_ID",
  action: "coupon-create",
  payload: {
    name: "<value>",
    currency: "<value>",
    available: "<value>",
    productId: "<value>",
    // formId: "<value>",
    codes: "<value>",
    discounts: "<value>",
    // expires: "<value>",
  },
});

if (isActionRun(envelope)) console.log(envelope.value);
Install the CLI
npm install -g @w6w/cli
CLI
w6w run conn_YOUR_CONNECTION_ID --action coupon-create --payload '{"name":"<value>","currency":"<value>","available":"<value>","productId":"<value>","codes":"<value>","discounts":"<value>"}'

Give an AI agent RegFox — without giving it RegFox's credentials. One MCP endpoint exposes every app, function and workflow the caller is entitled to, as tools it can discover and run. Access is granted per team while we onboard.

One tool call
{
  "name": "w6w_invoke",
  "arguments": {
    "ref": "app:io.w6w.regfox#coupon-create",
    "input": {
      "name": "<name>",
      "currency": "<currency>",
      "available": "<available>"
    }
  }
}

Every tool names its target with a single ref. The app: form above doesn't name a connection at all — the host resolves which of the caller's RegFox connections to sign with, and refuses rather than guesses when the answer is ambiguous.

What the agent gets

Credentials it can't read

The token is attached host-side, at the moment of the call. It is never a tool argument, never in the model's context, and never in a transcript — so a prompt injection has nothing to exfiltrate.

A tool surface scoped to the caller

Tools are derived per end user from what that person has actually connected and is entitled to — not one shared bot identity carrying the union of everyone's access.

A durable workflow in one call

Multi-step work runs on the workflow engine and returns a run handle the agent can poll — retries, branching and state survive the conversation that started them.

Health-aware discovery

RegFox's declared health checks are on the surface too, so an agent can tell "the vendor is down" from "your credential expired" before it burns a retry on either.

The MCP surface is part of the hosted platform. RegFox itself is MIT, and the runtime that executes it is source-available (FSL).

Request MCP access

Health checks

RegFox declares its own checks, so its health is a property of the app rather than something the host guesses at.

service

RegFox platform status

dependency

API reachable

Unsigned GET https://api.webconnex.com/v2/public/ping. Passes on the documented `{responseCode:200,data}` envelope. The endpoint is public, so this does not test the API key.

quota

API rate-limit headroom

Requests remaining in the daily window, from the X-Daily-* response headers (the burst window is reported alongside).