# Zoho Zeptomail Integration via LowCodeAPI

## Overview

Email service

## Base Endpoint

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

## Authentication

LowCodeAPI handles authentication automatically. You only need to:

1. **Sign up** at [Zoho Zeptomail](https://www.zoho.com/zeptomail)
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**: TOKEN

## API Categories

- **Batch Email Sending** - 1 endpoints
- **Email Sending API** - 1 endpoints
- **File Cache Upload API** - 1 endpoints
- **Templates API - Batch Emails** - 6 endpoints
- **Templates API - Single Email** - 1 endpoints

## Common Endpoints

### Category: Batch Email Sending

#### Send a batch of transactional emails

**Method**: `POST` | **LowCodeAPI Path**: `/v1.1/email/batch`

**Full URL**:
```
https://api.lowcodeapi.com/zohozeptomail/v1.1/email/batch?api_token={api_token}
```

**Description**: The API is used to send a batch of transactional emails

**Request Body**:
```json
{
  "from": "<object>",
  "to": "<array>",
  "subject": "<string>"
}
```

---

### Category: Email Sending API

#### Send transactional emails

**Method**: `POST` | **LowCodeAPI Path**: `/v1.1/email`

**Full URL**:
```
https://api.lowcodeapi.com/zohozeptomail/v1.1/email?api_token={api_token}
```

**Description**: The API is used to send transactional emails

**Request Body**:
```json
{
  "from": "<object>",
  "to": "<array>",
  "subject": "<string>"
}
```

---

### Category: File Cache Upload API

#### Upload files to File Cache

**Method**: `POST` | **LowCodeAPI Path**: `/v1.1/files`

**Full URL**:
```
https://api.lowcodeapi.com/zohozeptomail/v1.1/files?api_token={api_token}
```

**Description**: The API is used to upload files to File Cache

**Request Body**:
```json
{
  "key": "value"
}
```

---

### Category: Templates API - Batch Emails

#### Send a batch of emails using the template

**Method**: `POST` | **LowCodeAPI Path**: `/v1.1/email/template/batch`

**Full URL**:
```
https://api.lowcodeapi.com/zohozeptomail/v1.1/email/template/batch?api_token={api_token}
```

**Description**: The API is used to send a batch of transactional emails using the template

**Request Body**:
```json
{
  "template_key": "<string>",
  "from": "<object>",
  "to": "<array>"
}
```

---

#### Adding email templates

**Method**: `POST` | **LowCodeAPI Path**: `/v1.1/mailagents/mailagent_alias/templates`

**Full URL**:
```
https://api.lowcodeapi.com/zohozeptomail/v1.1/mailagents/mailagent_alias/templates?api_token={api_token}
```

**Description**: This API can be used to add an email template

**Path Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
|`mailagent_alias` | string | Yes | It is available in the Setup info section of your Mail Agent |

**Request Body**:
```json
{
  "template_name": "<string>",
  "subject": "<string>",
  "htmlbody": "<string>"
}
```

---

#### Update email template

**Method**: `PUT` | **LowCodeAPI Path**: `/v1.1/mailagents/mailagent_alias/templates/template_key`

**Full URL**:
```
https://api.lowcodeapi.com/zohozeptomail/v1.1/mailagents/mailagent_alias/templates/template_key?api_token={api_token}
```

**Description**: This API is used to edit your existing templates

**Path Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
|`mailagent_alias` | string | Yes | It is available in the Setup info section of your Mail Agent |
|`template_key` | string | Yes | Unique key for the template |

**Request Body**:
```json
{
  "template_name": "<string>",
  "subject": "<string>",
  "htmlbody": "<string>"
}
```

---

#### Get email templates

**Method**: `GET` | **LowCodeAPI Path**: `/v1.1/mailagents/mailagent_alias/templatestemplate_key`

**Full URL**:
```
https://api.lowcodeapi.com/zohozeptomail/v1.1/mailagents/mailagent_alias/templatestemplate_key?api_token={api_token}
```

**Description**: This API is used to fetch a particular email template

**Path Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
|`mailagent_alias` | string | Yes | It is available in the Setup info section of your Mail Agent |
|`template_key` | string | Yes | Unique key for the template |

---

#### List email templates

**Method**: `GET` | **LowCodeAPI Path**: `/v1.1/mailagents/mailagent_alias/templates`

**Full URL**:
```
https://api.lowcodeapi.com/zohozeptomail/v1.1/mailagents/mailagent_alias/templates?offset={offset}&limit={limit}&api_token={api_token}
```

**Description**: You can use this API to list the required number of email templates

**Path Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
|`mailagent_alias` | string | Yes | It is available in the Setup info section of your Mail Agent |

**Query Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
|`offset` | number | No | Offset |
|`limit` | number | No | Limit |

---

#### Delete template

**Method**: `DELETE` | **LowCodeAPI Path**: `/v1.1/mailagents/mailagent_alias/templatestemplate_key`

**Full URL**:
```
https://api.lowcodeapi.com/zohozeptomail/v1.1/mailagents/mailagent_alias/templatestemplate_key?api_token={api_token}
```

**Description**: This API can be used to delete a template using template key.

**Path Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
|`mailagent_alias` | string | Yes | It is available in the Setup info section of your Mail Agent |
|`template_key` | string | Yes | Unique key for the template |

---

### Category: Templates API - Single Email

#### Send one email at a time using the template

**Method**: `POST` | **LowCodeAPI Path**: `/v1.1/email/template`

**Full URL**:
```
https://api.lowcodeapi.com/zohozeptomail/v1.1/email/template?api_token={api_token}
```

**Description**: The API is used to send one transactional email at a time using the template

**Request Body**:
```json
{
  "template_key": "<string>",
  "from": "<object>",
  "to": "<array>",
  "merge_info": "<object>"
}
```

---

## Complete Endpoint Reference

For a complete list of all 10 endpoints, refer to:
- **OpenAPI Definition**: `https://backend.lowcodeapi.com/zohozeptomail/definition`
- **Official Provider Documentation**: https://www.zoho.com/zeptomail/email-api.html