---
title: "Create attachment"
method: POST
path: "/seller/listings/{id}/attachments"
tags: ["seller-listings"]
---

# Create attachment

`POST /seller/listings/{id}/attachments`

Create a draft attachment upload for a listing and return a direct upload URL.

This is step 1 of the listing attachment workflow.

Workflow:
1. Call this endpoint to obtain `id` and `uploadURL`.
2. Upload the image bytes directly to the returned URL.
3. Call finalize attachment to validate and persist the attachment on the listing.

Rules:
- Listing must belong to the authenticated seller.
- Listing must be active (`quantity > 0`).
- The returned image identifier is namespaced to the listing and seller context.

Response:
- Returns an `ImageUpload` payload with the image identifier and direct upload URL.

## Path parameters

- `id` string, required — Listing ID

## Response `200`

Upload URL

- ImageUpload — Direct upload URL for an image
  - `id` string, required — Image identifier
  - `uploadURL` string, uri, required — URL to upload the image

## Other responses

- `404` — Listing not found

---

[API](https://skmtc.net/managem/apis/managem-api.md) · [All operations](https://skmtc.net/managem/apis/managem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/managem/managem-api/versions/e8d78a3a2e8b/schema)