Zoho Projects API for Developers

Events API

All Events
GET  /portal/[PORTALID]/projects/[PROJECTID]/events/
Add Event
POST  /portal/[PORTALID]/projects/[PROJECTID]/events/
Update Event
POST  /portal/[PORTALID]/projects/[PROJECTID]/events/[EVENTID]/
Delete Event
DELETE /portal/[PORTALID]/projects/[PROJECTID]/events/[EVENTID]/

All Events

GET  /portal/[PORTALID]/projects/[PROJECTID]/events/

Gets all the events in the given project.

Request Parameters

index int Index number of the event.
range int Range of the events.
status* String Status of the event must be open or closed.

Sample Response

Status: 200 Success
Content Type: application/json;charset=utf-8
{
"events": [{
"id": 170876000001825009,
"title": "Finance Team Meeting",
"location": "",
"scheduled_on": "05-10-2014 04:30 PM",
"scheduled_on_long": 1399719600000,
"reminder": "on time",
"repeat": "only once",
"occurrence(s)": 1,
"occurred": 0,
"duration_hour": "1",
"duration_minutes": "30",
"is_open": false,
"participants": [{
"participant_id": "2060559",
"participant_person": "Jasmine Frank"
}, {
"participant_id": "2060755",
"participant_person": "Manish Patel"
}, {
"participant_id": "2060761",
"participant_person": "Einhard Klein"
}]
}]
}

Add Event

POST  /portal/[PORTALID]/projects/[PROJECTID]/events/

Adds an event.

Request Parameters

title* String Name of the event.
date* String [MM-DD-YYYY] Date of the event.
hour* String [hh] Hour of the event.
minutes* String [mm] Minutes of the event.
ampm* String am or pm of the event.
duration_hour* String [hh] Duration of the event in hours.
duration_mins* String [mm] Duration of the event in minutes.
participants* Long Participants of the event. Multiple particpants must be provided with comma separated user ID's.
remind_before String Reminder for the event. The reminder must be triggered to remind on time or 15 mins or 30 mins or 1 hour or 2 hours or 6 hours or 12 hours or 1 day.
repeat String Reminder occurrences for the event. It must be only once or every day or every week or every month or every year.
nooftimes_repeat String Count of the reminder occurrence. It must be an integer value between 2 to 10.
location String Location of the event.

Sample Response

Status: 201 Created
Content Type: application/json;charset=utf-8
{
"events": [{
"id": 170876000001851033,
"title": "Discussion with Developers",
"location": "",
"scheduled_on": "05-27-2014 02:30 AM",
"scheduled_on_long": 1401138000000,
"reminder": "on time",
"repeat": "only once",
"occurrence(s)": 1,
"occurred": 0,
"duration_hour": "2",
"duration_minutes": "30",
"is_open": false,
"participants": [{
"participant_id": "2060559",
"participant_person": "Jasmine Frank"
}, {
"participant_id": "2060758",
"participant_person": "Patricia Boyle"
}, {
"participant_id": "2063348",
"participant_person": "Charles Stone"
}]
}]
}

Update Event

POST  /portal/[PORTALID]/projects/[PROJECTID]/events/[EVENTID]/

Updates the event.

Request Parameters

title* String Name of the event.
date* String [MM-DD-YYYY] Date of the event.
hour* String [hh] Hour of the event.
minutes* String [mm] Minutes of the event.
ampm* String am or pm of the event.
duration_hour* String [hh] Duration of the event in hours.
duration_mins* String [mm] Duration of the event in minutes.
participants* Long Participants of the event. Multiple participants must be provided with comma separated user ID's.
remind_before String Reminder for the event. The reminder must be triggered to remind on time or 15 mins or 30 mins or 1 hour or 2 hours or 6 hours or 12 hours or 1 day.
repeat String Reminder occurrences for the event. It must be only once or every day or every week or every month or every year.
nooftimes_repeat String Count of the reminder occurrence. It must be an integer value between 2 to 10.
location String Location of the event.

Sample Response

Status: 200 Success
Content Type: application/json;charset=utf-8
{
"events": [{
"id": 170876000001851033,
"title": "Discussion with Developers",
"location": "Conf. Room",
"scheduled_on": "05-27-2014 01:30 PM",
"scheduled_on_long": 1401177600000,
"reminder": "on time",
"repeat": "only once",
"occurrence(s)": 1,
"occurred": 0,
"duration_hour": "2",
"duration_minutes": "00",
"is_open": true,
"participants": [{
"participant_id": "2060559",
"participant_person": "Jasmine Frank"
}, {
"participant_id": "2060758",
"participant_person": "Patricia Boyle"
}, {
"participant_id": "2063348",
"participant_person": "Charles Stone"
}]
}]
}

Delete Event

DELETE /portal/[PORTALID]/projects/[PROJECTID]/events/[EVENTID]/

Deletes the event.

Sample Response

Status: 200 Success
Content Type: application/json;charset=utf-8
{
"response": "Event Deleted Successfully"
}

Top