API Method /calendars/new
Creates a new calendar. See http://eventful.com/calendars/new for an example interface.
Arguments
- authentication
- This method requires user authentication.
- calendar_name string
- The calendar name.
- description string
- The calendar description. (optional)
- tags string
- A space-delimited list of tags. (optional)
- privacy integer
- The privacy setting for this calendar. (1 = public, 2 = private, 3 = semi-private) (optional, defaults to 1)
- where_query string
- Specified location to search in for smart calendar- the "where". (optional)
- what_query string
- The keywords to use for smart calendar - the "what". (optional)
- notify_schedule string
- Choice to notify owner on updates to calendar either "immediately", "daily", or "weekly". (optional)
-
Example Request
Here's an example request URL:
http://api.evdb.com/rest/calendars/new?...&calendar_name=jogging+in+san+diego&what_query=running%7C%7Cwalking&where_query=san+diego
Output Parameters
Output from this function is an XML block with the following constructs:
- status string
- ok
- idstring
- The calendar ID of the newly created calendar.
- messagestring
- Calendar added successfully.
Example XML Response
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
<id>C0-001-000002272-8</id>
<message>Calendar added successfully.</message>
</response>
Error Codes
This method may return these errors in an error document:
- Authentication error
- The specified user was not found or provided invalid credentials.
- Title Required
- The title parameter was not set.
- Calendar exists
- A calendar named 'name' already exists.