# Zoho Calendar Integration via LowCodeAPI

## Overview

Calendar application

## Base Endpoint

```
https://api.lowcodeapi.com/zohocalendar/
```

## Authentication

LowCodeAPI handles authentication automatically. You only need to:

1. **Sign up** at [Zoho Calendar](https://www.zoho.com/calendar)
2. **Get your credentials** from [credential page]( https://accounts.zoho.com/developerconsole)
3. **Connect your account** in LowCodeAPI dashboard
4. **Use your `api_token`** in all requests

**Auth Type**: OAUTH2.0

## API Categories

- **Activity logs** - 1 endpoints
- **Calendars API** - 5 endpoints
- **Events API** - 10 endpoints
- **Free/ Busy API** - 1 endpoints
- **Groups API** - 1 endpoints
- **Notification API** - 2 endpoints
- **Search API** - 1 endpoints
- **Settings API** - 2 endpoints
- **Share API** - 2 endpoints
- **Smart Add API** - 1 endpoints

## Common Endpoints

### Category: Activity logs

#### Activity logs

**Method**: `GET` | **LowCodeAPI Path**: `/api/v1/organization/activity`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/organization/activity?api_token={api_token}
```

**Description**: This API is used to get the activity logs of the user

---

### Category: Calendars API

#### Get calendar list

**Method**: `GET` | **LowCodeAPI Path**: `/api/v1/calendars`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/calendars?api_token={api_token}
```

**Description**: This API is used to get the list of all calendars or list of calendars based on a specific category/entity of a given user

---

#### Get calendar details

**Method**: `GET` | **LowCodeAPI Path**: `/api/v1/calendars/calendar_uid|default|primary`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/calendars/calendar_uid|default|primary?api_token={api_token}
```

**Description**: This API retrieves the details of a particular calendar using the Calendar UID

**Path Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
|`CALENDAR_UID` | string | Yes | If you want to get the details of a particular calendar using calendar UID |
|`default` | string | No |  If you want to get the default calendar details |
|`primary` | string | No | If you want to get the default calendar details |

---

#### Create new calendar

**Method**: `POST` | **LowCodeAPI Path**: `/api/v1/calendars`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/calendars?api_token={api_token}
```

**Description**: This API helps in creating a new calendar

---

#### Update calendar

**Method**: `PUT` | **LowCodeAPI Path**: `/api/v1/calendars/calendaruid`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/calendars/calendaruid?api_token={api_token}
```

**Description**: This API is used to update an existing calendar

---

#### Delete calendar

**Method**: `DELETE` | **LowCodeAPI Path**: `/api/v1/calendars/calendaruid`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/calendars/calendaruid?api_token={api_token}
```

**Description**: This API is used to delete a calendar using the calendar identifier

---

### Category: Events API

#### Get events list

**Method**: `GET` | **LowCodeAPI Path**: `/api/v1/calendars/calendar_uid/events`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/calendars/calendar_uid/events?api_token={api_token}
```

**Description**: This API is used to get a list of all the events in a particular calendar of the user

---

#### Get event details

**Method**: `GET` | **LowCodeAPI Path**: `/api/v1/calendars/calendar_uid/events/event_uid`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/calendars/calendar_uid/events/event_uid?api_token={api_token}
```

**Description**: This API is used to get the event details of a specific event in the user's calendar

---

#### Get attachment details

**Method**: `GET` | **LowCodeAPI Path**: `/api/v1/calendars/cal_uid/events/event_uid/attachment/file_id`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/calendars/cal_uid/events/event_uid/attachment/file_id?api_token={api_token}
```

**Description**: This API is used to get the details of a specific attachment in a particular event

---

#### Get group attendees details

**Method**: `GET` | **LowCodeAPI Path**: `/api/v1/calendars/calendar_uid/events/event_uid/groupattendeestatus`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/calendars/calendar_uid/events/event_uid/groupattendeestatus?api_token={api_token}
```

**Description**: This API is used to get the group attendees details of a specific event in the user's calendar

---

#### Get Event By Instance

**Method**: `GET` | **LowCodeAPI Path**: `/api/v1/calendars/calendar_uid/events/event_uid/byinstance`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/calendars/calendar_uid/events/event_uid/byinstance?api_token={api_token}
```

**Description**: This API is used to get all instances of a particular repeat event

---

#### Create a new event

**Method**: `POST` | **LowCodeAPI Path**: `/api/v1/calendars/calendar_uid/events`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/calendars/calendar_uid/events?api_token={api_token}
```

**Description**: This API is used to create a new event in a user's calendar

---

#### Attach file

**Method**: `POST` | **LowCodeAPI Path**: `/api/v1/attachment`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/attachment?api_token={api_token}
```

**Description**: This API is used to attach a file to an event in the calendar

---

#### Delete attachment

**Method**: `PUT` | **LowCodeAPI Path**: `/api/v1/calendars/calendar_uid/events/event_uid`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/calendars/calendar_uid/events/event_uid?api_token={api_token}
```

**Description**: This API is used to delete attachment from an event.

---

#### Delete event

**Method**: `DELETE` | **LowCodeAPI Path**: `/api/v1/calendars/calendar_uid/events/event_uid`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/calendars/calendar_uid/events/event_uid?api_token={api_token}
```

**Description**: This API is used to delete an event from a user's calendar

---

#### Move event

**Method**: `PUT` | **LowCodeAPI Path**: `/api/v1/calendars/calendaruid/events/eventuid`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/calendars/calendaruid/events/eventuid?api_token={api_token}
```

**Description**: This API is used to move event from one calendar to other

---

### Category: Free/ Busy API

#### Get user's free/ busy details

**Method**: `GET` | **LowCodeAPI Path**: `/api/v1/calendars/freebusy`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/calendars/freebusy?api_token={api_token}
```

**Description**: This API is used to get the free/busy details of the user from all the calendars

---

### Category: Groups API

#### Get Group Calendar list

**Method**: `GET` | **LowCodeAPI Path**: `/api/v1/groups`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/groups?api_token={api_token}
```

**Description**: To get the list of all group calendars

---

### Category: Notification API

#### Get notification details

**Method**: `GET` | **LowCodeAPI Path**: `/api/v1/notification`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/notification?api_token={api_token}
```

**Description**: This API is used to get the notification details of a particular user

---

#### Update notification details

**Method**: `PUT` | **LowCodeAPI Path**: `/api/v1/notification`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/notification?api_token={api_token}
```

**Description**: This API is used to update the notification details of a particular user

---

### Category: Search API

#### Get event through search

**Method**: `GET` | **LowCodeAPI Path**: `/api/v1/calendars/calendaruid/search`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/calendars/calendaruid/search?api_token={api_token}
```

**Description**: This API is used to get a particular event from a calendar through search

---

### Category: Settings API

#### Get calendar settings

**Method**: `GET` | **LowCodeAPI Path**: `/api/v1/settings`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/settings?api_token={api_token}
```

**Description**: This API is used to get the calendar settings of the user

---

#### Update calendar settings

**Method**: `PUT` | **LowCodeAPI Path**: `/api/v1/settings`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/settings?api_token={api_token}
```

**Description**: This API is used to update the calendar settings of the user

---

### Category: Share API

#### Get shared calendar details

**Method**: `GET` | **LowCodeAPI Path**: `/api/v1/calendars/calendar_uid/share`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/calendars/calendar_uid/share?api_token={api_token}
```

**Description**: This API is used to get the calendar details of a calendar that has been shared with another user.

**Path Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
|`calendaruid` | string | Yes | Calendar unique identifier |

---

#### Share calendar

**Method**: `PUT` | **LowCodeAPI Path**: `/api/v1/calendars/calendar_uid/share`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/calendars/calendar_uid/share?api_token={api_token}
```

**Description**: This API is used to update the calendar that is shared with another user

**Path Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
|`calendaruid` | string | Yes | Calendar unique identifier |

---

### Category: Smart Add API

#### Create event using Smart Add

**Method**: `POST` | **LowCodeAPI Path**: `/api/v1/smartadd`

**Full URL**:
```
https://api.lowcodeapi.com/zohocalendar/api/v1/smartadd?api_token={api_token}
```

**Description**: This API is used to create a new event in a particular calendar using Smart Add

---

## Complete Endpoint Reference

For a complete list of all 26 endpoints, refer to:
- **OpenAPI Definition**: `https://backend.lowcodeapi.com/zohocalendar/definition`
- **Official Provider Documentation**: https://www.zoho.com/calendar/help/api/introduction.html