Skip to main content

Create a new listing.

Create a brand-new listing (Tour) under the calling agency's hierarchy. The owner_user_id is resolved from the API key's media_agency_id - any value a client smuggles in the body is ignored. Idempotent on X-Idempotency-Key.

MethodPath
POST/api/v1/listings

Primary host: https://valara.cloud (legacy alias: https://dash.jacoballenmedia.com).

Parameters​

(no path or query parameters)

Request body​

(no request body)

Response​

null

Responses​

StatusDescription
201Successful Response
422Validation Error (see error codes)

Examples​

curl​

curl -X POST "https://valara.cloud/api/v1/listings" \
  -H "Authorization: Bearer $VALARA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: $(uuidgen)"

Python​

import os
import uuid
import httpx
res = httpx.request(
    "POST",
    "https://valara.cloud/api/v1/listings",
    headers={
    "Authorization": f"Bearer {os.environ['VALARA_API_KEY']}",
    "Content-Type": "application/json",
    "X-Idempotency-Key": str(uuid.uuid4()),
    },
)
res.raise_for_status()
print(res.json())

See also​