Skip to main content
Glama

create_ad_order

Book a flight against a quote_id from estimate_ad_cost, with creative assets. Price and impressions come from the stored quote — anything you send that contradicts it is ignored. Returns an order_id and a Stripe checkout URL for the exact quoted amount. Pass idempotency_key to make retries safe.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
headlineNoShort sponsor headline.
quote_idYesREQUIRED. The quote ID from estimate_ad_cost.
click_urlYesDestination HTTPS click-through URL.
image_urlNoHTTPS display creative (required for display formats).
brand_nameYesBrand or sponsor company name.
ad_categoryYesREQUIRED. What the sponsor sells. alcohol and betting ads are shown only to signed in fans who have told us they are 21 or over; general ads are shown to everyone.
artist_nameNoArtist name (required for music slots).
track_titleNoTrack title (required for music slots).
voice_scriptNo10-15s spoken script, max 35 words (required for voice_sponsor_read).
cover_art_urlNoCover artwork image URL.
idempotency_keyNoOptional. Reuse on retry to avoid double-booking.
advertiser_emailNoOptional buyer email for the Stripe receipt.
audio_stream_urlNoHTTPS audio stream (required for music slots).
rights_confirmedNoMust be true for music slots: you confirm licensing or ownership.
selected_personaNoAI persona voicing the read.
streaming_platform_urlNoSpotify / Apple Music / SoundCloud link.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / ad_category
      Added value: +{
      +  "description": "REQUIRED. What the sponsor sells. alcohol and betting ads are shown only to signed in fans who have told us they are 21 or over; general ads are shown to everyone.",
      +  "enum": [
      +    "general",
      +    "alcohol",
      +    "betting"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "quote_id",
      -  "brand_name",
      -  "click_url"
      -]New value: +[
      +  "quote_id",
      +  "ad_category",
      +  "brand_name",
      +  "click_url"
      +]
  2. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources