Skip to content

Privacy and analytics

We use necessary technical cookies and, only with your consent, analytics and marketing pixels to improve the website and measure campaigns.

Privacy policyCookie policy
Docs
GuidesDevelopers
English
EspañolEnglishFrançaisDeutschItalianoPortuguês

Start building

  • Your first API call
  • Limits, versions and headers

API

  • Brand API
    • Errors
    • Permissions and roles
    • Events and webhooks
    • Brand
    • Genome
    • Brand Kit
    • Library
    • Works
    • Calendar
    • Connections
    • Publishing
    • Inbox
    • Team
    • Account and team
    • Conversation
    • Memory
    • Questions
    • Media
    • Store
    • Plan
    • Orders
    • Activity
    • Workspace
    • Your account
    • Billing
    • Sync
    • Website and domains
    • Statistics
    • Mailing
    • Media
    • Events

MCP

  • MCP server

Connectors

  • Brand connectors
API/Brand API
Reference16 min read

Media

Advertising spaces of approved media owners: search and book them and, for a media owner, sell them and keep their stock.

Русский
한국어
日本語
中文
हिन्दी
Open the app
On this page
  • adspaces.access.get · Media access
  • adspaces.interest.set · Tell me when Media is available
  • adspaces.search · Search advertising spaces
  • adspaces.listings.get · Read an advertising space
  • adspaces.listings.file_open · Open a space template
  • adspaces.bookings.request · Request an advertising space
  • adspaces.bookings.list · Advertising bookings
  • adspaces.bookings.get · Read a booking
  • adspaces.bookings.file_open · Open a booking file
  • adspaces.bookings.cancel · Cancel a booking
  • adspaces.bookings.material_submit · Deliver a booking's material
  • adspaces.bookings.complete · Accept a delivered booking
  • adspaces.bookings.review · Rate a booking
  • adspaces.seller.access.get · Whether the workspace sells advertising spaces
  • adspaces.seller.overview · Media owner overview
  • adspaces.seller.profile.save · Save the media owner profile
  • adspaces.seller.profile.submit · Send the media owner for review
  • adspaces.seller.uploads.prepare · Prepare a file upload
  • adspaces.seller.properties.list · Media owner properties
  • adspaces.seller.properties.save · Save a property
  • adspaces.seller.listings.list · Media owner spaces
  • adspaces.seller.listings.get · Read a media owner space
  • adspaces.seller.listings.file_open · Open a template of a media owner space
  • adspaces.seller.listings.save · Save a space
  • adspaces.seller.listings.submit · Send a space for review
  • adspaces.seller.listings.state_set · Pause, resume or deactivate a space
  • adspaces.seller.rates.set · Set a space's rate rules
  • adspaces.seller.availability.list · A space's calendar
  • adspaces.seller.availability.upsert · Open or close a space's dates
  • adspaces.seller.availability.remove · Remove calendar windows
  • adspaces.seller.bookings.list · Bookings the media owner receives
  • adspaces.seller.bookings.get · Read a received booking
  • adspaces.seller.bookings.decide · Accept or decline a booking
  • adspaces.seller.bookings.material_review · Review a booking's material
  • adspaces.seller.bookings.deliver · Deliver a booking's proof
  • adspaces.seller.bookings.file_open · Open a received booking's file
  • adspaces.seller.payouts.list · Media owner payouts
  • adspaces.seller.payouts.invoice_set · Attach a payout's invoice
  • adspaces.seller.payout_account.set · Change the media owner's bank account
  • adspaces.seller.team.get · Media owner team
  • adspaces.seller.team.duties_set · Set a person's functions

The exact input and output of each operation are in /api/v1/openapi.json with your token, or from an agent with nomad_describe.

adspaces.access.get · Media access

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/adspaces.access.get
MCP tooladspaces_access_get
Scopeadspaces.read
Minimum roleViewer
Human confirmationNo
DoorsAPI, MCP, Screens, Apps, Nödo
StatusAvailable

adspaces.interest.set · Tell me when Media is 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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.interest.set
MCP tooladspaces_interest_set
Scopeadspaces.write
Minimum roleViewer
Human confirmationNo
DoorsAPI, MCP, Screens, Apps, Nödo
StatusAvailable

adspaces.search · Search advertising spaces

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/adspaces.search
MCP tooladspaces_search
Scopeadspaces.read
Minimum roleViewer
Human confirmationNo
DoorsAPI, MCP, Screens, Apps, Nödo
StatusAvailable

adspaces.listings.get · Read an advertising space

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/adspaces.listings.get
MCP tooladspaces_listings_get
Scopeadspaces.read
Minimum roleViewer
Human confirmationNo
DoorsAPI, MCP, Screens, Apps, Nödo
StatusAvailable

adspaces.listings.file_open · Open a space template

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/adspaces.listings.file_open
MCP tooladspaces_listings_file_open
Scopeadspaces.read
Minimum roleViewer
Human confirmationNo
DoorsAPI, MCP, Screens, Apps, Nödo
StatusAvailable

adspaces.bookings.request · Request an advertising space

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.bookings.request
MCP tooladspaces_bookings_request
Scopeadspaces.write
Minimum roleMember
Human confirmationYes
DoorsAPI, MCP, Screens, Apps, Nödo
StatusAvailable

adspaces.bookings.list · Advertising bookings

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/adspaces.bookings.list
MCP tooladspaces_bookings_list
Scopeadspaces.read
Minimum roleViewer
Human confirmationNo
DoorsAPI, MCP, Screens, Apps, Nödo
StatusAvailable

adspaces.bookings.get · Read a booking

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/adspaces.bookings.get
MCP tooladspaces_bookings_get
Scopeadspaces.read
Minimum roleViewer
Human confirmationNo
DoorsAPI, MCP, Screens, Apps, Nödo
StatusAvailable

adspaces.bookings.file_open · Open a booking file

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/adspaces.bookings.file_open
MCP tooladspaces_bookings_file_open
Scopeadspaces.read
Minimum roleViewer
Human confirmationNo
DoorsAPI, MCP, Screens, Apps, Nödo
StatusAvailable

adspaces.bookings.cancel · Cancel a booking

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).

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.bookings.cancel
MCP tooladspaces_bookings_cancel
Scopeadspaces.write
Minimum roleMember
Human confirmationYes
DoorsAPI, MCP, Screens, Apps, Nödo
StatusAvailable

adspaces.bookings.material_submit · Deliver a booking's material

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.bookings.material_submit
MCP tooladspaces_bookings_material_submit
Scopeadspaces.write
Minimum roleMember
Human confirmationNo
DoorsAPI, MCP, Screens, Apps, Nödo
StatusAvailable

adspaces.bookings.complete · Accept a delivered booking

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.bookings.complete
MCP tooladspaces_bookings_complete
Scopeadspaces.write
Minimum roleMember
Human confirmationNo
DoorsAPI, MCP, Screens, Apps, Nödo
StatusAvailable

adspaces.bookings.review · Rate a booking

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.bookings.review
MCP tooladspaces_bookings_review
Scopeadspaces.write
Minimum roleMember
Human confirmationNo
DoorsAPI, MCP, Screens, Apps, Nödo
StatusAvailable

adspaces.seller.access.get · Whether the workspace sells advertising spaces

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/adspaces.seller.access.get
MCP tooladspaces_seller_access_get
Scopeadspaces.read
Minimum roleworkspace.adspaces.view
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.overview · Media owner overview

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/adspaces.seller.overview
MCP tooladspaces_seller_overview
Scopeadspaces.read
Minimum roleworkspace.adspaces.view
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.profile.save · Save the media owner profile

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.seller.profile.save
MCP tooladspaces_seller_profile_save
Scopeadspaces.write
Minimum roleworkspace.adspaces.edit
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.profile.submit · Send the media owner for review

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.seller.profile.submit
MCP tooladspaces_seller_profile_submit
Scopeadspaces.write
Minimum roleworkspace.adspaces.edit
Human confirmationYes
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.uploads.prepare · Prepare a file upload

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).

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.seller.uploads.prepare
MCP tooladspaces_seller_uploads_prepare
Scopeadspaces.write
Minimum roleworkspace.adspaces.view
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.properties.list · Media owner properties

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/adspaces.seller.properties.list
MCP tooladspaces_seller_properties_list
Scopeadspaces.read
Minimum roleworkspace.adspaces.view
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.properties.save · Save a property

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.seller.properties.save
MCP tooladspaces_seller_properties_save
Scopeadspaces.write
Minimum roleworkspace.adspaces.edit
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.listings.list · Media owner spaces

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/adspaces.seller.listings.list
MCP tooladspaces_seller_listings_list
Scopeadspaces.read
Minimum roleworkspace.adspaces.view
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.listings.get · Read a media owner space

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/adspaces.seller.listings.get
MCP tooladspaces_seller_listings_get
Scopeadspaces.read
Minimum roleworkspace.adspaces.view
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.listings.file_open · Open a template of a media owner space

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/adspaces.seller.listings.file_open
MCP tooladspaces_seller_listings_file_open
Scopeadspaces.read
Minimum roleworkspace.adspaces.view
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.listings.save · Save a space

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.seller.listings.save
MCP tooladspaces_seller_listings_save
Scopeadspaces.write
Minimum roleworkspace.adspaces.edit
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.listings.submit · Send a space for review

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.seller.listings.submit
MCP tooladspaces_seller_listings_submit
Scopeadspaces.write
Minimum roleworkspace.adspaces.edit
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.listings.state_set · Pause, resume or deactivate a space

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.seller.listings.state_set
MCP tooladspaces_seller_listings_state_set
Scopeadspaces.write
Minimum roleworkspace.adspaces.edit
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.rates.set · Set a space's rate rules

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.seller.rates.set
MCP tooladspaces_seller_rates_set
Scopeadspaces.write
Minimum roleworkspace.adspaces.edit
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.availability.list · A space's calendar

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/adspaces.seller.availability.list
MCP tooladspaces_seller_availability_list
Scopeadspaces.read
Minimum roleworkspace.adspaces.view
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.availability.upsert · Open or close a space's dates

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.seller.availability.upsert
MCP tooladspaces_seller_availability_upsert
Scopeadspaces.write
Minimum roleworkspace.adspaces.edit
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.availability.remove · Remove calendar windows

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.seller.availability.remove
MCP tooladspaces_seller_availability_remove
Scopeadspaces.write
Minimum roleworkspace.adspaces.edit
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.bookings.list · Bookings the media owner receives

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/adspaces.seller.bookings.list
MCP tooladspaces_seller_bookings_list
Scopeadspaces.read
Minimum roleworkspace.adspaces.view
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.bookings.get · Read a received booking

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/adspaces.seller.bookings.get
MCP tooladspaces_seller_bookings_get
Scopeadspaces.read
Minimum roleworkspace.adspaces.view
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.bookings.decide · Accept or decline a booking

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.seller.bookings.decide
MCP tooladspaces_seller_bookings_decide
Scopeadspaces.write
Minimum roleworkspace.adspaces.sell
Human confirmationYes
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.bookings.material_review · Review a booking's material

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.seller.bookings.material_review
MCP tooladspaces_seller_bookings_material_review
Scopeadspaces.write
Minimum roleworkspace.adspaces.sell
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.bookings.deliver · Deliver a booking's proof

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.seller.bookings.deliver
MCP tooladspaces_seller_bookings_deliver
Scopeadspaces.write
Minimum roleworkspace.adspaces.sell
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.bookings.file_open · Open a received booking's file

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/adspaces.seller.bookings.file_open
MCP tooladspaces_seller_bookings_file_open
Scopeadspaces.read
Minimum roleworkspace.adspaces.view
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.payouts.list · Media owner payouts

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/adspaces.seller.payouts.list
MCP tooladspaces_seller_payouts_list
Scopeadspaces.read
Minimum roleworkspace.adspaces.payouts
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.payouts.invoice_set · Attach a payout's invoice

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.seller.payouts.invoice_set
MCP tooladspaces_seller_payouts_invoice_set
Scopeadspaces.write
Minimum roleworkspace.adspaces.payouts
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.payout_account.set · Change the media owner's bank account

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.seller.payout_account.set
MCP tooladspaces_seller_payout_account_set
Scopeadspaces.write
Minimum roleworkspace.adspaces.payouts
Human confirmationYes
DoorsScreens, Apps
StatusAvailable

adspaces.seller.team.get · Media owner team

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.

FieldValue
KindRead
HTTP methodPOST /api/v1/adspaces.seller.team.get
MCP tooladspaces_seller_team_get
Scopeadspaces.read
Minimum roleworkspace.adspaces.view
Human confirmationNo
DoorsScreens, API, Apps
StatusAvailable

adspaces.seller.team.duties_set · Set a person's functions

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.

FieldValue
KindWrite
HTTP methodPOST /api/v1/adspaces.seller.team.duties_set
MCP tooladspaces_seller_team_duties_set
Scopeadspaces.write
Minimum roleworkspace.members.manage
Human confirmationYes
DoorsScreens, Apps
StatusAvailable
PreviousMailingNextEvents

In this section

  • Errors
  • Permissions and roles
  • Events and webhooks
  • Brand
  • Genome
  • Brand Kit
  • Library
  • Works
Can't find what you need? Write to usWrite to usGo to the app
© 2026 Nömad · Nömad documentationLinkedInInstagramThreadsFacebookTikTokYouTubeX
Go to nomad.oooBack to top

On this page

  • adspaces.access.get · Media access
  • adspaces.interest.set · Tell me when Media is available
  • adspaces.search · Search advertising spaces
  • adspaces.listings.get · Read an advertising space
  • adspaces.listings.file_open · Open a space template
  • adspaces.bookings.request · Request an advertising space
  • adspaces.bookings.list · Advertising bookings
  • adspaces.bookings.get · Read a booking
  • adspaces.bookings.file_open · Open a booking file
  • adspaces.bookings.cancel · Cancel a booking
  • adspaces.bookings.material_submit · Deliver a booking's material
  • adspaces.bookings.complete · Accept a delivered booking
  • adspaces.bookings.review · Rate a booking
  • adspaces.seller.access.get · Whether the workspace sells advertising spaces
  • adspaces.seller.overview · Media owner overview
  • adspaces.seller.profile.save · Save the media owner profile
  • adspaces.seller.profile.submit · Send the media owner for review
  • adspaces.seller.uploads.prepare · Prepare a file upload
  • adspaces.seller.properties.list · Media owner properties
  • adspaces.seller.properties.save · Save a property
  • adspaces.seller.listings.list · Media owner spaces
  • adspaces.seller.listings.get · Read a media owner space
  • adspaces.seller.listings.file_open · Open a template of a media owner space
  • adspaces.seller.listings.save · Save a space
  • adspaces.seller.listings.submit · Send a space for review
  • adspaces.seller.listings.state_set · Pause, resume or deactivate a space
  • adspaces.seller.rates.set · Set a space's rate rules
  • adspaces.seller.availability.list · A space's calendar
  • adspaces.seller.availability.upsert · Open or close a space's dates
  • adspaces.seller.availability.remove · Remove calendar windows
  • adspaces.seller.bookings.list · Bookings the media owner receives
  • adspaces.seller.bookings.get · Read a received booking
  • adspaces.seller.bookings.decide · Accept or decline a booking
  • adspaces.seller.bookings.material_review · Review a booking's material
  • adspaces.seller.bookings.deliver · Deliver a booking's proof
  • adspaces.seller.bookings.file_open · Open a received booking's file
  • adspaces.seller.payouts.list · Media owner payouts
  • adspaces.seller.payouts.invoice_set · Attach a payout's invoice
  • adspaces.seller.payout_account.set · Change the media owner's bank account
  • adspaces.seller.team.get · Media owner team
  • adspaces.seller.team.duties_set · Set a person's functions