BUbuttondown
Advertising Units

Create Advertising Unit

Changed on

Create a new advertising unit

post/advertising_units

Request

  • Base URL
    https://api.buttondown.com/v1
  • URL
    https://api.buttondown.com/v1/advertising_units
  • Auth
    API key in header Authorization

Request body

titlestring required

The title of the advertising unit.

descriptionstring

A description of the advertising unit.

behaviorstring

The behavior type of the advertising unit.

urlstring

The URL for the advertising unit's landing page.

priceinteger nullable

The price in the smallest currency unit.

allows_htmlboolean

Whether the advertising unit accepts HTML content.

allows_imageboolean

Whether the advertising unit accepts an image.

max_charactersinteger nullable

Maximum number of characters allowed for the ad content.

submission_deadline_daysinteger

Number of days before the slot date that content must be submitted.

Response

Created

idstring required

A unique TypeID associated with the object.

creation_datestring date-time required

The date and time at which the object was first created.

status'active' | 'inactive' required

An enumeration.

titlestring required

The title of the advertising unit.

descriptionstring required

A description of the advertising unit.

behaviorstring required

The behavior type of the advertising unit.

urlstring required

The URL for the advertising unit's landing page.

priceinteger nullable

The price in the smallest currency unit, or null if not set.

allows_htmlboolean required

Whether the advertising unit accepts HTML content.

allows_imageboolean required

Whether the advertising unit accepts an image.

max_charactersinteger nullable

Maximum number of characters allowed for the ad content.

submission_deadline_daysinteger required

Number of days before the slot date that content must be submitted.

Changes

  • 228cc05ba97dRevision changes
    • info

      added the non-success response with the status

  • 13f3bc084194Revision changes
    • breaking

      the request property became required

    • breaking

      response property price list-of-types was widened by adding types null to media type application/json of response 201

    • breaking

      response property slots/items/invoice_url list-of-types was widened by adding types null to media type application/json of response 201

    • breaking

      the response's property type changed from no type to string for status

    • breaking

      the response's property type changed from no type to string for status

    • warning

      the request property's maxLength was set to 100

    • warning

      added the new held enum value to the // response property for the response status

    • info

      the endpoint scheme security ApiKeyAuth was added to the API

    • info

      the endpoint scheme security PermissionAuthenticationRequirement was removed from the API

    • info

      api tag Advertising Units added

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      the request property default value was added

    • info

      request property list-of-types was widened by adding types null to media type application/json

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property to the response with the status