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

# POST /events/{id}

`POST /events/{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/events/{id}`
- Auth: none declared

## Path parameters

- `id` integer, required
- `password` string

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

- object
  - `author` integer: The event author ID
  - `date` string: The event publication date
  - `date_utc` string: The event publication date (UTC time zone)
  - `title` string: The event title
  - `description` string: The event description
  - `slug` string: The event slug
  - `excerpt` string: The event excerpt
  - `status` string: The event post status
  - `timezone` string: The event time zone
  - `all_day` boolean: Whether the event lasts the whole day or not
  - `start_date` string: The event start date and time
  - `end_date` string: The event end date and time
  - `image` string: The event featured image ID or URL
  - `cost` string: The event cost
  - `website` string: The event website URL
  - `show_map` boolean: Whether the event should show a map or not
  - `show_map_link` boolean: Whether the event should show a map link or not
  - `hide_from_listings` boolean: Whether events should be hidden in the calendar view or not
  - `sticky` boolean: Whether the event should be sticky in the calendar view or not
  - `featured` boolean: Whether the event should be featured on the site or not
  - `categories` integer[]: The event category ID or name
  - `tags` integer[]: The event tag ID or name
  - `venue` integer[]: The event venue IDs or data
  - `organizer` integer[]: The event organizer IDs or data

## Response `200`

Returns the data of the updated event

- Event
  - `id` integer: The event WordPress post ID
  - `global_id` string: The event ID used to globally identify in Event Aggregator
  - `global_id_lineage` string[]: An Array containing the lineage of where this event comes from, this should not change after the event is created.
  - `author` integer: The event author WordPress post ID
  - `date` string: The event creation date in the site time zone
  - `date_utc` string: The event creation date in UTC time
  - `modified` string: The event last modification date in the site time zone
  - `modified_utc` string: The event last modification date in UTC time
  - `status` string: The event status
  - `url` string: The URL to the event page
  - `rest_url` string: The TEC REST API link to fetch this event
  - `title` string: The event name
  - `description` string: The event long description
  - `excerpt` string: The event short description
  - `slug` string: The event 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
  - `all_day` boolean: Whether or not this event is an all day Event
  - `start_date` string: The event start date in the event or site time zone
  - `start_date_details` DateDetails[]: An array of each component of the event start date
    - `year` integer: The date year
    - `month` integer: The date month
    - `day` integer: The date day
    - `hour` integer: The date hour
    - `minutes` integer: The date minutes
    - `seconds` integer: The date seconds
  - `end_date` string: The event end date in the event or site time zone
  - `end_date_details` DateDetails[]: An array of each component of the event end date
    - `year` integer: The date year
    - `month` integer: The date month
    - `day` integer: The date day
    - `hour` integer: The date hour
    - `minutes` integer: The date minutes
    - `seconds` integer: The date seconds
  - `utc_start_date` string: The event start date in UTC time
  - `utc_start_date_details` DateDetails[]: An array of each component of the event start date in UTC time
    - `year` integer: The date year
    - `month` integer: The date month
    - `day` integer: The date day
    - `hour` integer: The date hour
    - `minutes` integer: The date minutes
    - `seconds` integer: The date seconds
  - `utc_end_date` string: The event end date in UTC time
  - `utc_end_date_details` DateDetails[]: An array of each component of the event end date in UTC time
    - `year` integer: The date year
    - `month` integer: The date month
    - `day` integer: The date day
    - `hour` integer: The date hour
    - `minutes` integer: The date minutes
    - `seconds` integer: The date seconds
  - `timezone` string: The event time zone string
  - `timezone_abbr` string: The abbreviated event time zone string
  - `cost` string: The event cost including the currency symbol
  - `cost_details` CostDetails[]: The event cost details
    - `currency_symbol` string: The cost currency symbol
    - `currency_position ` 'prefix' | 'postfix': The position of the currency symbol in the cost string
    - `values` integer[]: A sorted array of all the numeric values for the cost
  - `website` string: The event website URL
  - `show_map` boolean: Whether the map should be shown for the event or not
  - `show_map_link` boolean: Whether the map link should be shown for the event or not
  - `hide_from_listings` boolean: Whether an event should be hidden from the calendar view or not
  - `sticky` boolean: Whether an event is sticky in the calendar view or not
  - `featured` boolean: Whether the event is featured in the calendar or not
  - `categories` Term[]: The event categories
    - `id` integer: The WordPress term ID
    - `name` string: The term name
    - `slug` string: The term slug
    - `taxonomy` string: The taxonomy the term belongs to
    - `description` string: The term description
    - `parent` integer: The term parent term if any
    - `count` integer: The number of posts associated with the term
    - `url` string: The URL to the term archive page
    - `urls` string[]: A list of links to the term own, archive and parent REST URL
  - `tags` Term[]: The event tags
    - `id` integer: The WordPress term ID
    - `name` string: The term name
    - `slug` string: The term slug
    - `taxonomy` string: The taxonomy the term belongs to
    - `description` string: The term description
    - `parent` integer: The term parent term if any
    - `count` integer: The number of posts associated with the term
    - `url` string: The URL to the term archive page
    - `urls` string[]: A list of links to the term own, archive and parent REST URL
  - `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
  - `organizer` Organizer[]: The event organizers
    - `id` integer: The organizer WordPress post ID
    - `global_id` string: The organizer 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 organizer author WordPress post ID
    - `date` string: The organizer creation date in the site time zone
    - `date_utc` string: The organizer creation date in UTC time
    - `modified` string: The organizer last modification date in the site time zone
    - `modified_utc` string: The organizer last modification date in UTC time
    - `status` string: The organizer status
    - `url` string: The URL to the organizer page
    - `organizer` string: The organizer name
    - `description` string: The organizer long description
    - `excerpt` string: The organizer short description
    - `slug` string: The organizer 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
    - `phone` string: The organizer phone number
    - `website` string: The organizer website
    - `email` string: The organizer email address

## Other responses

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

---

[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)
