Connect ChatGPT (Custom GPT Actions) to Convene

If your team uses ChatGPT instead of Claude, you can connect Convene as a Custom GPT Action. Once set up, anyone you share the GPT with can ask it to look up data or take action in your Convene account.

Heads up: Custom GPT Actions require a paid ChatGPT plan (Plus, Team, or Enterprise).

Step 1: Create a new GPT

In ChatGPT, click your name → My GPTs → Create a GPT. Give it a name like "My Market Assistant" and a short description.

Step 2: Add an Action

In the GPT builder, switch to the Configure tab and scroll to Actions → Create new action.

📸 Screenshot: ChatGPT Action configuration panel

Step 3: Set up authentication

Under Authentication, choose:

• Authentication Type: API Key
• API Key: your Convene token (starts with fm_org_)
• Auth Type: Bearer

Step 4: Paste the schema

ChatGPT needs a short OpenAPI schema so it knows what endpoints exist. Paste this in as a starter — it covers the most common actions:

openapi: 3.0.0
info:
  title: Convene Admin API
  version: "1.0"
servers:
  - url: https://app.convene.markets/api/v1/admin
paths:
  /dashboard:
    get:
      operationId: getDashboard
      summary: Org summary (pending orders, apps, upcoming dates)
  /vendor_applications:
    get:
      operationId: listApplications
      summary: List vendor applications
  /orders:
    get:
      operationId: listOrders
      summary: List orders
  /bookings:
    get:
      operationId: listBookings
      summary: List bookings
  /markets:
    get:
      operationId: listMarkets
      summary: List markets

You can extend the schema to include any other endpoint you want ChatGPT to call. See the developer reference for the full list.

Step 5: Write a system prompt

In the Instructions field, give your GPT some context. For example:

You are a helpful assistant for a farmers-market organizer. Use the Convene Admin API to look up pending applications, orders, bookings, and market dates. Always confirm destructive actions (approvals, cancellations, emails) with the user before making them. If you're unsure which order or vendor the user means, ask for clarification.

Step 6: Try it

Save your GPT and open a chat. Try "what's on my dashboard?" or "show me pending applications." ChatGPT will call Convene using your key and answer with real data.

Keeping it private

When you save the GPT, choose "Only me" or "Only people with a link" — not "Public." The GPT is tied to your API key, so anyone who uses it can read and change your organization's data.