FOforem
billboards

Create a billboard

Changed on

Create a new billboard. Successful writes log api_billboard_create with the actor and target ids in the admin API audit log.

    ### Parameter Options & Tips:
    - **body_markdown**: The HTML/Markdown advertisement copy.
    - **placement_area**: Target region in layouts (e.g. `post_comments` below comments, `sidebar` in sidebars, `home_feed` between posts).
    - **display_to**: Cohort target rules (e.g. `all` for everyone, `logged_in`, `guests`, or customized segments).
    - **target_geolocations**: Comma-separated ISO codes for country/region targeting.
    - **approved** & **published**: Set to `true` to activate billboard rotation instantly.
post/api/billboards

Request

  • Base URL
    https://dev.to
  • Auth
    • API key in header api-key
    • or HTTP bearer

Request body

object required

Response

A billboard

object required

Changes

  • v16875ab97119cRevision changes
    • warning

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

    • info

      added the new external_feed enum value to the request property /

  • v11aa2b47406f7Revision changes
    • warning

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

    • warning

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

    • warning

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

    • info

      added the new post_body_bottom_secondary enum value to the request property /

    • info

      added the new post_comments_secondary enum value to the request property /

    • info

      added the new post_sidebar_secondary enum value to the request property /