Skip to main content
POST
Create media billing entity (admin)

Authorizations

Authorization
string
header
required

API key or access token

Body

application/json

Create a media billing entity for configuration and resolution previews. The invoice producer does not consume these records yet.

entityName
string
required

Legal name of the media billing entity (e.g. "WPP South Africa (Pty) Ltd").

Required string length: 1 - 255
countryCode
string
required

Stored country identity metadata for the billing entity, as an ISO 3166-1 alpha-2 code. It does not derive currency, tax/address behavior, or resolution.

Pattern: ^[A-Z]{2}$
Example:

"US"

currency
string
required

ISO 4217 currency code

Pattern: ^[A-Z]{3}$
Example:

"USD"

billingEmails
string<email>[]
required

Invoicing contact email(s) for this entity. At least one is required.

Required array length: 1 - 20 elements
Pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
addressLine1
string
required

Entity street address, line 1.

Required string length: 1 - 255
city
string
required

Entity city.

Required string length: 1 - 128
postalCode
string
required

Entity postal/ZIP code.

Required string length: 1 - 32
addressLine2
string

Entity street address, line 2 (optional).

Maximum string length: 255
state
string

Entity state/province/region (optional).

Maximum string length: 128
taxId
string

Tax identifier for this entity (e.g. VAT number, EIN), when applicable.

Maximum string length: 64
isPrimary
boolean

Set true to make this the org's PRIMARY media billing entity, demoting any other primary entity. The primary is the fallback in resolution previews when no advertiser or account attachment matches. Omit to leave the current primary/non-primary status unchanged. An org's FIRST entity always becomes primary regardless of this field.

Response

Create media billing entity (admin)

entity
object
required

A media billing configuration entity used by resolution previews. The invoice producer does not consume it yet.