Media
Advertising spaces of approved media owners: search and book them and, for a media owner, sell them and keep their stock.
Privacy and analytics
We use necessary technical cookies and, only with your consent, analytics and marketing pixels to improve the website and measure campaigns.
Advertising spaces of approved media owners: search and book them and, for a media owner, sell them and keep their stock.
The exact input and output of each operation are in /api/v1/openapi.json with your token, or from an agent with nomad_describe.
Says whether the Media section (the marketplace of third-party advertising spaces) is open for this brand, and what the caller may do there: book, pay. Call it before the other adspaces.* operations: while enabled is false they answer not_available. soon means it is announced but not open yet; interested, that the caller asked to be told when it opens (adspaces.interest.set). Changes nothing.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/adspaces.access.get |
| MCP tool | adspaces_access_get |
| Scope | adspaces.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | API, MCP, Screens, Apps, Nödo |
| Status | Available |
Puts the caller on the list of people to tell when the Media section opens for this brand (interested: true) or takes them off it. Only the caller's own wish; it books and charges nothing. Answers not_available when the section is neither announced nor open for the brand.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.interest.set |
| MCP tool | adspaces_interest_set |
| Scope | adspaces.write |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | API, MCP, Screens, Apps, Nödo |
| Status | Available |
Published advertising spaces of approved media owners (digital, print, radio, outdoor, venues…), newest first. Filter by text, channel, city, saleUnit and maxPriceMinor (per unit). With startsOn and quantity each result carries quote: the price without VAT for those dates and whether they are free, on request or taken. Prices are what the brand pays; no costs. Changes nothing.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/adspaces.search |
| MCP tool | adspaces_search |
| Scope | adspaces.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | API, MCP, Screens, Apps, Nödo |
| Status | Available |
One advertising space in full: description, gallery, the technical sheet the creative must follow, downloadable templates (templateFiles[].id → adspaces.listings.file_open), the property's audience, the delivery limits (leadDays to book, materialDays to deliver the creative), the days already closed or taken for the next twelve months and, with startsOn (and quantity, else the minimum), its price. not_found for a space that is not published. Changes nothing.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/adspaces.listings.get |
| MCP tool | adspaces_listings_get |
| Scope | adspaces.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | API, MCP, Screens, Apps, Nödo |
| Status | Available |
Returns where to download one creative template of a published space right now. fileId comes from adspaces.listings.get (templateFiles[].id). The address expires in minutes: ask again each time. Changes nothing.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/adspaces.listings.file_open |
| MCP tool | adspaces_listings_file_open |
| Scope | adspaces.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | API, MCP, Screens, Apps, Nödo |
| Status | Available |
Asks for an advertising space for dates. Charges nothing: Nömad reviews the request, the media owner accepts or declines it, and only an accepted booking is paid (by a person, with orders.installments.start). The price is frozen now. Fails with conflict and the reason (dates_unavailable, lead_time, quantity_below_minimum, listing_not_bookable…) when it cannot be asked.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.bookings.request |
| MCP tool | adspaces_bookings_request |
| Scope | adspaces.write |
| Minimum role | Member |
| Human confirmation | Yes |
| Doors | API, MCP, Screens, Apps, Nödo |
| Status | Available |
The brand's bookings of advertising spaces, newest first: status, dates, price without VAT, the state of the creative material and its deadline. state narrows to the ones still in progress (open) or finished (closed). Changes nothing.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/adspaces.bookings.list |
| MCP tool | adspaces_bookings_list |
| Scope | adspaces.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | API, MCP, Screens, Apps, Nödo |
| Status | Available |
One booking in full: what was booked (frozen), its price, its payment (payment.installmentId → orders.installments.start), the delivered material, the media owner's proof (proofs[].id → adspaces.bookings.file_open) and results, its history and can: what the caller may do now. Changes nothing.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/adspaces.bookings.get |
| MCP tool | adspaces_bookings_get |
| Scope | adspaces.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | API, MCP, Screens, Apps, Nödo |
| Status | Available |
Returns where to download one template or proof of publication of one of the brand's bookings right now. fileId comes from adspaces.bookings.get (templateFiles[].id, proofs[].id). The address expires in minutes. Changes nothing.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/adspaces.bookings.file_open |
| MCP tool | adspaces_bookings_file_open |
| Scope | adspaces.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | API, MCP, Screens, Apps, Nödo |
| Status | Available |
Cancels a booking that has not been paid yet (requested, with the media owner, or accepted and waiting for payment); the held slot is released. A paid booking is cancelled by Nömad, who handles the refund: this answers conflict (wrong_status).
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.bookings.cancel |
| MCP tool | adspaces_bookings_cancel |
| Scope | adspaces.write |
| Minimum role | Member |
| Human confirmation | Yes |
| Doors | API, MCP, Screens, Apps, Nödo |
| Status | Available |
Delivers the creative to the media owner: the chosen files of the brand's Library (brandFileIds, from library.*) replace any sent before and the booking waits for the media owner to accept them or ask for changes. Allowed once the booking is accepted and while the material is pending or changes were requested.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.bookings.material_submit |
| MCP tool | adspaces_bookings_material_submit |
| Scope | adspaces.write |
| Minimum role | Member |
| Human confirmation | No |
| Doors | API, MCP, Screens, Apps, Nödo |
| Status | Available |
Accepts the media owner's proof of publication of a delivered booking, which closes it. A delivered booking nobody disputes closes by itself after a few days.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.bookings.complete |
| MCP tool | adspaces_bookings_complete |
| Scope | adspaces.write |
| Minimum role | Member |
| Human confirmation | No |
| Doors | API, MCP, Screens, Apps, Nödo |
| Status | Available |
Leaves the brand's rating of a delivered or completed booking: 1 to 5 and an optional comment, read by Nömad and by the media owner. One per booking; sending it again replaces it.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.bookings.review |
| MCP tool | adspaces_bookings_review |
| Scope | adspaces.write |
| Minimum role | Member |
| Human confirmation | No |
| Doors | API, MCP, Screens, Apps, Nödo |
| Status | Available |
Says whether this workspace is a media owner (it has a publisher record and sells advertising spaces) and its approval status. Call it before the other adspaces.seller.* operations: for a workspace that is not a media owner they answer not_found. Changes nothing.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/adspaces.seller.access.get |
| MCP tool | adspaces_seller_access_get |
| Scope | adspaces.read |
| Minimum role | workspace.adspaces.view |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
The media owner record of this workspace: its profile and approval status (draft, in_review, approved, rejected, suspended), what is still missing to send it for review, counts of properties, spaces and bookings that need an answer, and can: which parts the caller may edit, sell or settle. not_found when the workspace does not sell advertising spaces. Changes nothing.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/adspaces.seller.overview |
| MCP tool | adspaces_seller_overview |
| Scope | adspaces.read |
| Minimum role | workspace.adspaces.view |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
Changes the media owner's public profile (name, tagline, description, website, channels, logo, cover) and its legal details. Only the fields sent change; null clears one. Images are paths from adspaces.seller.uploads.prepare. Does not send it for review: that is adspaces.seller.profile.submit.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.seller.profile.save |
| MCP tool | adspaces_seller_profile_save |
| Scope | adspaces.write |
| Minimum role | workspace.adspaces.edit |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
Sends the media owner's profile to Nömad for approval, from draft or rejected. Needs acceptTerms: true and a complete profile (overview.missing empty apart from the bank account); otherwise answers conflict (not_ready). Only an approved media owner can publish spaces.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.seller.profile.submit |
| MCP tool | adspaces_seller_profile_submit |
| Scope | adspaces.write |
| Minimum role | workspace.adspaces.edit |
| Human confirmation | Yes |
| Doors | Screens, API, Apps |
| Status | Available |
Returns a one-time signed upload address for a file of the media owner: a showcase image (logo, cover, gallery: JPEG, PNG, WebP or AVIF up to 10 MB), a creative template, a proof of publication or an invoice (any type up to 50 MB). PUT the bytes to uploadUrl, then send path to the operation that uses it. Each purpose needs the key of its part (edit, sell or payouts).
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.seller.uploads.prepare |
| MCP tool | adspaces_seller_uploads_prepare |
| Scope | adspaces.write |
| Minimum role | workspace.adspaces.view |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
The media owner's properties: the things that have an audience (a website, a print title, a radio station, an outdoor circuit, a venue), with place, audience and how many spaces each holds. Deactivated ones included. Changes nothing.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/adspaces.seller.properties.list |
| MCP tool | adspaces_seller_properties_list |
| Scope | adspaces.read |
| Minimum role | workspace.adspaces.view |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
Creates a property (no propertyId; name and channel required) or changes one (only the fields sent change; null clears one). isActive: false deactivates it: its spaces leave the search and its bookings in progress go on. A property is never deleted.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.seller.properties.save |
| MCP tool | adspaces_seller_properties_save |
| Scope | adspaces.write |
| Minimum role | workspace.adspaces.edit |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
The media owner's advertising spaces, newest first: status (draft, in_review, published, paused, rejected), whether editorial changes wait for review, sale unit, capacity and the media owner's own net price per unit. Filter by propertyId or status. Changes nothing.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/adspaces.seller.listings.list |
| MCP tool | adspaces_seller_listings_list |
| Scope | adspaces.read |
| Minimum role | workspace.adspaces.view |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
One of the media owner's spaces in full: the published content, the editorial changes waiting for review (pending), delivery limits, capacity, the net price per unit and its rate rules. Calendar windows are adspaces.seller.availability.list. Changes nothing.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/adspaces.seller.listings.get |
| MCP tool | adspaces_seller_listings_get |
| Scope | adspaces.read |
| Minimum role | workspace.adspaces.view |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
Returns where to download right now one creative template of one of the media owner's spaces, published or waiting for review. fileId comes from adspaces.seller.listings.get (templateFiles[].id, pending.templateFiles[].id). The address expires in minutes. Changes nothing.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/adspaces.seller.listings.file_open |
| MCP tool | adspaces_seller_listings_file_open |
| Scope | adspaces.read |
| Minimum role | workspace.adspaces.view |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
Creates a draft space (no listingId; propertyId, title, saleUnit and unitCostMinor required) or changes one; only the fields sent change. On a published space the editorial fields (title, summary, description, format, specs, accepted files, templates, cover, gallery) wait for Nömad's review while brands keep seeing the published version; price, capacity, quantities and delivery limits apply at once. Send expectedVersion to refuse a stale write.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.seller.listings.save |
| MCP tool | adspaces_seller_listings_save |
| Scope | adspaces.write |
| Minimum role | workspace.adspaces.edit |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
Sends a draft or rejected space to Nömad for publication. The media owner must be approved (publisher_not_approved otherwise) and the space needs a description and a cover (not_ready). Editorial changes to a published space are sent by saving them; this is only for the first publication.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.seller.listings.submit |
| MCP tool | adspaces_seller_listings_submit |
| Scope | adspaces.write |
| Minimum role | workspace.adspaces.edit |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
Changes whether a space sells: pause hides a published space from the search, resume shows it again, deactivate retires it (it keeps its history) and activate brings it back. Bookings in progress go on in every case. A space is never deleted.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.seller.listings.state_set |
| MCP tool | adspaces_seller_listings_state_set |
| Scope | adspaces.write |
| Minimum role | workspace.adspaces.edit |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
Replaces the rate rules of a space: a different net price per unit for a date range (season), for weekdays of the first day, or from a quantity up. The most specific matching rule wins; with none, the space's own price applies. Applies at once to new requests; bookings already asked keep their frozen price. An empty list clears the rules.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.seller.rates.set |
| MCP tool | adspaces_seller_rates_set |
| Scope | adspaces.write |
| Minimum role | workspace.adspaces.edit |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
The calendar of a space between from and to (default: today and the next twelve months): its windows (closed blocks dates; open opens them, optionally with its own capacity) and the days its bookings take. Changes nothing.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/adspaces.seller.availability.list |
| MCP tool | adspaces_seller_availability_list |
| Scope | adspaces.read |
| Minimum role | workspace.adspaces.view |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
Creates or updates calendar windows of a space, at once and without review: this is how a media owner keeps its stock. A window with id or with an externalRef already known is updated; otherwise it is created, so a sync that sends its own ids as externalRef is safe to repeat. closed blocks the dates; open opens them (needed when the space only sells listed dates) and may carry its own capacity.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.seller.availability.upsert |
| MCP tool | adspaces_seller_availability_upsert |
| Scope | adspaces.write |
| Minimum role | workspace.adspaces.edit |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
Removes calendar windows of a space by ids or by externalRefs. Bookings are not touched: a booking already accepted keeps its dates. Unknown ids are ignored; removed says how many went.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.seller.availability.remove |
| MCP tool | adspaces_seller_availability_remove |
| Scope | adspaces.write |
| Minimum role | workspace.adspaces.edit |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
The bookings that reached the media owner, newest first: brand, space, dates, what the media owner earns and the state of the creative. A booking appears once Nömad has passed it on (pending_publisher). state: to_answer (waiting for accept or decline), open (in progress) or closed. Filter by listingId. Changes nothing.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/adspaces.seller.bookings.list |
| MCP tool | adspaces_seller_bookings_list |
| Scope | adspaces.read |
| Minimum role | workspace.adspaces.view |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
One received booking in full: the brand and its brief, the delivered creative (materials[].id → adspaces.seller.bookings.file_open), the proof and results already sent, its history and can: what the caller may do now. Carries what the media owner earns, never what the brand pays. Changes nothing.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/adspaces.seller.bookings.get |
| MCP tool | adspaces_seller_bookings_get |
| Scope | adspaces.read |
| Minimum role | workspace.adspaces.view |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
Answers a booking waiting for the media owner. accept holds the slot while the brand pays; if it does not pay in time the booking expires and the slot is free again. decline needs a note the brand will read. conflict (dates_unavailable) when the dates were taken meanwhile.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.seller.bookings.decide |
| MCP tool | adspaces_seller_bookings_decide |
| Scope | adspaces.write |
| Minimum role | workspace.adspaces.sell |
| Human confirmation | Yes |
| Doors | Screens, API, Apps |
| Status | Available |
Answers the creative a brand delivered: approve accepts it, changes sends it back with a note saying what to fix (required). Only while the material is submitted.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.seller.bookings.material_review |
| MCP tool | adspaces_seller_bookings_material_review |
| Scope | adspaces.write |
| Minimum role | workspace.adspaces.sell |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
Delivers the proof of publication of a paid booking that has started: files uploaded with adspaces.seller.uploads.prepare (purpose proof), figures (metrics: impressions, airings, copies…) and a note. The brand accepts it or the booking closes by itself after a few days; closed bookings enter the next payout.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.seller.bookings.deliver |
| MCP tool | adspaces_seller_bookings_deliver |
| Scope | adspaces.write |
| Minimum role | workspace.adspaces.sell |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
Returns where to download right now one file of a booking the media owner received: the brand's creative or a proof already sent. fileId comes from adspaces.seller.bookings.get. The address expires in minutes. Changes nothing.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/adspaces.seller.bookings.file_open |
| MCP tool | adspaces_seller_bookings_file_open |
| Scope | adspaces.read |
| Minimum role | workspace.adspaces.view |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
What Nömad pays the media owner: its payouts (open, invoiced or paid, each with its bookings count and amount), the amount of finished bookings not yet in a payout, and the bank account it is paid to, masked. Changes nothing.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/adspaces.seller.payouts.list |
| MCP tool | adspaces_seller_payouts_list |
| Scope | adspaces.read |
| Minimum role | workspace.adspaces.payouts |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
Attaches the invoice the media owner issues to Nömad for an open payout: its number and the file uploaded with adspaces.seller.uploads.prepare (purpose invoice). The payout becomes invoiced and Nömad pays it by bank transfer. Refused on a payout already paid.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.seller.payouts.invoice_set |
| MCP tool | adspaces_seller_payouts_invoice_set |
| Scope | adspaces.write |
| Minimum role | workspace.adspaces.payouts |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
Saves the bank account (holder and IBAN) Nömad pays the media owner to. Only a signed-in person with a recent sign-in, never a token or an agent. A changed account is unverified until Nömad checks it, and nothing is paid to it meanwhile. Answers the account masked.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.seller.payout_account.set |
| MCP tool | adspaces_seller_payout_account_set |
| Scope | adspaces.write |
| Minimum role | workspace.adspaces.payouts |
| Human confirmation | Yes |
| Doors | Screens, Apps |
| Status | Available |
The people of the workspace with their role and the advertising-space functions each holds on top of it (editor, sales, finance), and what each can therefore do. Names only, no emails. Changes nothing.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/adspaces.seller.team.get |
| MCP tool | adspaces_seller_team_get |
| Scope | adspaces.read |
| Minimum role | workspace.adspaces.view |
| Human confirmation | No |
| Doors | Screens, API, Apps |
| Status | Available |
Sets which advertising-space functions a member of the workspace holds on top of their role: editor (spaces, rates, calendar), sales (bookings, material, proofs), finance (payouts and bank account). The list replaces the previous one; an empty list removes them all. Nobody gives a function they do not hold themselves.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/adspaces.seller.team.duties_set |
| MCP tool | adspaces_seller_team_duties_set |
| Scope | adspaces.write |
| Minimum role | workspace.members.manage |
| Human confirmation | Yes |
| Doors | Screens, Apps |
| Status | Available |