---
title: "Creates a media asset based on the input passed in"
method: POST
path: "/api/v3/advertisers/{advertiserId}/media"
tags: ["Media"]
---

# Creates a media asset based on the input passed in

`POST /api/v3/advertisers/{advertiserId}/media`

## Request

- Base URL: `https://ads.nextdoor.com`
- URL: `https://ads.nextdoor.com/api/v3/advertisers/{advertiserId}/media`
- Auth: HTTP bearer

## Path parameters

- `advertiserId` string, required

## Request body `multipart/form-data`

- union
  - object
    - `type` 'logo'
    - `file` string, binary
    - `file_name` string
  - object
    - `type` 'canvas'
    - `file` string, binary
    - `file_name` string
    - `placement` 'feed' | 'fsf' | 'rhr'
  - object
    - `type` 'video'
    - `file_name` string
    - `file` string, binary

## Response `200`

The newly created media asset

- union
  - object
    - `created_at` string, date-time: The date when this media asset was created
    - `file_name` string: The name of the file being uploaded
    - `id` string: The media asset id
    - `mime_type` string: The mime type of the media uploaded
    - `public_url` string: The public url of the media uploaded
    - `type` string: The media asset type
    - `updated_at` string, date-time: The date when this media asset was updated
  - object
    - `created_at` string, date-time: The date when this media asset was created
    - `cropped_images` object[]: The list of cropped images associated with original(uncropped) image
      - `created_at` string, date-time: The date when this media asset was created
      - `file_name` string: The name of the file being uploaded
      - `id` string: The media asset id
      - `mime_type` string: The mime type of the media uploaded
      - `public_url` string: The public url of the media uploaded
      - `type` string: The media asset type
      - `updated_at` string, date-time: The date when this media asset was updated
    - `file_name` string: The name of the file being uploaded
    - `id` string: The media asset id
    - `mime_type` string: The mime type of the media uploaded
    - `public_url` string: The public url of the media uploaded
    - `type` string: The media asset type
    - `updated_at` string, date-time: The date when this media asset was updated
  - object
    - `created_at` string, date-time: The date when this media asset was created
    - `file_name` string: The name of the file being uploaded
    - `id` string: The media asset id
    - `mime_type` string: The mime type of the media uploaded
    - `public_url` string: The public url of the media uploaded
    - `type` string: The media asset type
    - `updated_at` string, date-time: The date when this media asset was updated

## Other responses

- `400`: Bad Request. Indicates that the server cannot process the request due to client-side error. For example invalid input.
- `401`: Unauthorized. The API key is invalid and needs to be re-generated.
- `403`: Forbidden. The token passed in has been successfully authenticated, but can’t perform the given action due to not having sufficient permissions.
- `500`: Internal server error.
- `503`: The server is temporarily unable to handle the request due to maintenance or overload.

---

[API](https://skmtc.dev/nextdoor/apis/advertising.md) - [All operations](https://skmtc.dev/nextdoor/apis/advertising/llms.txt) - [OpenAPI document](https://skmtc.dev/nextdoor/apis/advertising/revisions/cdbbecabcffc?raw)