Changelog
Versioning policy
- A breaking change means a new version,
/v2./v1keeps running for 12 more months after/v2opens. - Additions ship into
/v1at 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.
whoamireturns the account a key acts as. - Shows, for advertisers.
search_shows,get_show, andlist_show_slotssearch shows and read their prices and open ad slots. - My shows, for creators.
list_my_showsandget_my_showread the shows a creator is a member of, andlist_show_schedulereads a show's schedule. - Bookings.
list_bookingsandget_bookingread the bookings of a campaign, for an advertiser, or of a show, for a creator. - Invoices and payouts.
list_invoicesreads a campaign's invoices, for advertisers, andlist_payoutsreads a show's payouts, for creators. - Campaigns and carts, for advertisers.
list_campaigns,get_campaign, andcreate_campaign;start_campaign_buildandget_campaign_buildpick shows for a budget;add_cart_slots,remove_cart_slots,reserve_cart, andrelease_reservefill a cart and hold its slots. Nothing purchases. - Schedule and bookings, for creators.
add_episode,blackout_slots, andreopen_slotsmanage a show's schedule;submit_youtube_aircheck,set_social_post_link, andremove_social_post_linkdeliver on a booking;list_vetting_requestsandanswer_vetting_requestanswer 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.