Create listing
POSTCreate a new product listing in the Mediloop Marketplace.
/listingsAuthentication
OAuth 2.0
Permissions
marketplace:write
Rate limit
120 requests / min
Response
201 Created
Overview
Create a new product listing in the Mediloop Marketplace.
Endpoint
POST /listings
POST https://api.mediloop.com/v1/listings
Authorization: Bearer $ACCESS_TOKEN
X-Tenant-Id: $TENANT_IDAuthentication
Required scope:
marketplace:write. Access is also constrained by seller organization, tenant membership and Marketplace entitlement.Parameters
| Field | Type | Required | Description |
|---|---|---|---|
page | integer | No | Page number |
limit | integer | No | Items per page |
status | string | No | Filter by status |
q | string | No | Search query |
Example request
cURL
curl -X POST "https://api.mediloop.com/v1/listings" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"metadata":{"source":"erp"}}'Example response200 OK
{
"data": {
"id": "mkt_123",
"status": "created",
"updated_at": "2026-08-19T07:00:00Z"
}
}Example response
Marketplace responses use stable resource IDs and explicit lifecycle states so integrations can reconcile safely.
Responses
| HTTP | Meaning |
|---|---|
200 | Success |
201 | Created |
400 | Invalid request |
401 | Authentication required |
403 | Insufficient permissions |
404 | Resource not found |
409 | Business-state conflict |
429 | Rate limit exceeded |