---
title: "POST /venues/{id}"
method: POST
path: "/venues/{id}"
---

# POST /venues/{id}

`POST /venues/{id}`

## Request

- Base URL: `https://docs.theeventscalendar.com/index.php?rest_route=/tribe/events/v1`
- URL: `https://docs.theeventscalendar.com/index.php?rest_route=/tribe/events/v1/venues/{id}`
- Auth: none declared

## Path parameters

- `id` integer, required

## Request body `application/x-www-form-urlencoded`

- object
  - `author` integer: The venue author ID
  - `date` string: The venue publication date
  - `date_utc` string: The venue publication date (UTC time zone)
  - `venue` string: The venue name
  - `description` string: The venue description
  - `status` string: The venue post status
  - `show_map` string: Whether events linked to the venue should show a map or not
  - `show_map_link` string: Whether events linked to the venue should show a map link or not
  - `address` string: The venue address
  - `city` string: The venue city
  - `country` string: The venue country
  - `province` string: The venue province
  - `state` string: The venue state
  - `zip` string: The venue ZIP code
  - `phone` string: The venue phone number
  - `stateprovince` string: The venue state and province
  - `website` string: The venue website URL
  - `image` string: The organizer featured image ID or URL

## Response `200`

Returns the data of the updated venue

- Venue
  - `id` integer: The venue WordPress post ID
  - `global_id` string: The venue ID used to globally identify in Event Aggregator
  - `global_id_lineage` string[]: An Array containing the lineage of where this organizer comes from, this should not change after the organizer is created.
  - `author` integer: The venue author WordPress post ID
  - `date` string: The venue creation date in the site time zone
  - `date_utc` string: The venue creation date in UTC time
  - `modified` string: The venue last modification date in the site time zone
  - `modified_utc` string: The venue last modification date in UTC time
  - `status` string: The venue status
  - `url` string: The URL to the venue page
  - `venue` string: The venue name
  - `description` string: The venue long description
  - `excerpt` string: The venue short description
  - `slug` string: The venue slug
  - `image` Image
    - `url` string, uri: The URL to the full size version of the image
    - `id` integer: The image WordPress post ID
    - `extension` string: The image file extension
    - `width` integer: The image natural width in pixels
    - `height` integer: The image natural height in pixels
    - `sizes` ImageSize[]: The details about each size available for the image
      - `width` integer: The image width in pixels in the specified size
      - `height` integer: The image height in pixels in the specified size
      - `mime-type` string: The image mime-type
      - `url` string, uri: The link to the image in the specified size on the site
  - `show_map` boolean: Whether the map should be shown for the venue or not
  - `show_map_link` boolean: Whether the map link should be shown for the venue or not
  - `address` string: The venue address
  - `city` string: The venue city
  - `country` string: The venue country
  - `province` string: The venue province
  - `state` string: The venue state
  - `zip` string: The venue ZIP code
  - `phone` string: The venue phone number
  - `website` string: The venue website URL
  - `stateprovince` string: The venue state or province
  - `geo_lat` number, double: The venue geo latitude
  - `geo_lng` number, double: The venue geo longitude

## Other responses

- `201`: Returns the data of the created venue
- `400`: A required parameter is missing or an input parameter is in the wrong format
- `403`: The user is not authorized to create venues

---

[API](https://skmtc.dev/theeventscalendar/apis/the-events-calendar-rest-api.md) - [All operations](https://skmtc.dev/theeventscalendar/apis/the-events-calendar-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/theeventscalendar/apis/the-events-calendar-rest-api/revisions/ec2e0a6a611b?raw)
