Changelog

Versioning policy

  • A breaking change means a new version, /v2. /v1 keeps running for 12 more months after /v2 opens.
  • Additions ship into /v1 at any time and are listed here: a new operation, a new field, a new optional parameter, or a new allowed value. Write your code to ignore what it doesn't know.

A breaking change is one that can stop working code: removing or renaming an operation, a field, or a parameter, changing a field's type, or making an optional parameter required.

November 16, 2026: version 1

The first release.

  • Sign-in for AI agents. An AI client connects by sending you to gumball.fm to approve it, as read-only or read and write, with no key to paste. A connection ends after 30 days, and Connected Apps on Account Settings lists and disconnects them. See Authentication.
  • API keys. Create, view, and revoke keys on Account Settings, with read-only or read-and-write access and an expiry you choose.
  • Account. whoami returns the account a key acts as.
  • Shows, for advertisers. search_shows, get_show, and list_show_slots search shows and read their prices and open ad slots.
  • My shows, for creators. list_my_shows and get_my_show read the shows a creator is a member of, and list_show_schedule reads a show's schedule.
  • Bookings. list_bookings and get_booking read the bookings of a campaign, for an advertiser, or of a show, for a creator.
  • Invoices and payouts. list_invoices reads a campaign's invoices, for advertisers, and list_payouts reads a show's payouts, for creators.
  • Campaigns and carts, for advertisers. list_campaigns, get_campaign, and create_campaign; start_campaign_build and get_campaign_build pick shows for a budget; add_cart_slots, remove_cart_slots, reserve_cart, and release_reserve fill a cart and hold its slots. Nothing purchases.
  • Schedule and bookings, for creators. add_episode, blackout_slots, and reopen_slots manage a show's schedule; submit_youtube_aircheck, set_social_post_link, and remove_social_post_link deliver on a booking; list_vetting_requests and answer_vetting_request answer a brand's request.
  • API Activity. Every change made through the API is listed on its own page, linked from Account Settings.
  • MCP server. Every operation is also a tool for AI agents.
  • Docs. An interactive reference, guides, and plain-text copies for agents.

Coming

  • More to read: delivery.

Read this page as plain text.