Zoho Recruit — 零工招聘管理集成

Name: Zoho Recruit — 零工招聘管理集成
Rating: 1 (3 reviews)
Author: byungkyu

byungkyu

Zoho Recruit — 零工招聘管理集成

v1.0.3

Zoho Recruit API 集成，通过 Maton 网关管理 OAuth。用于读取、创建、更新或搜索招聘数据（候选人、职位、面试、申请等）。需要网络访问和有效的 Maton API 密钥。

3· 11,887·5 当前·7 累计·💬 3

by @byungkyu·MIT-0

API工具网络工具数据分析安全工作流

下载技能包

License

MIT-0

最后更新

2026/2/26

安全扫描

VirusTotal

无害

查看报告

OpenClaw

安全

medium confidence

该技能的要求和指令与其声明的目的相符（通过 Maton 网关集成 Zoho Recruit），主要风险在于招聘数据通过外部网关（maton.ai）传输，必须信任该服务和其 API 密钥处理。

评估建议

该技能内部一致，做了它声称的事情：通过 Maton 网关与 Zoho Recruit 通信，需要 MATON_API_KEY。安装前，请验证您信任 maton.ai（它将代理您的 Zoho 数据和 OAuth 令牌）。...

详细分析 ▾

✓ 用途与能力

技能名称/描述（Zoho Recruit 集成）与其要求一致：网络访问和 Maton API 密钥。

ℹ 指令范围

SKILL.md 只指示向 Maton 控制的端点发送 HTTP 请求和如何管理 OAuth 连接；

✓ 安装机制

没有安装规格或代码被提供（仅指令），因此安装过程中没有写入磁盘或下载内容。

ℹ 凭证需求

仅需要环境变量 MATON_API_KEY，这对于基于网关的集成是合理的。

✓ 持久化与权限

技能不请求 always:true 且仅限用户调用；它不尝试修改其他技能或全局代理设置。

安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

查看条款 ↗

运行时依赖

无特殊依赖

版本

latestv1.0.32026/2/6

添加了 clawdbot 元数据（包括表情符号和所需环境变量详细信息）到技能配置中，没有改变技能逻辑或 API 使用。

● 无害

安装命令点击复制

官方npx clawhub@latest install zoho-recruit

镜像加速npx clawhub@latest install zoho-recruit --registry https://www.longxiaskill.com

技能文档

通过托管 OAuth 认证访问 Zoho Recruit API。使用完整的 CRUD 操作管理候选人、职位空缺、面试、申请和招聘工作流程。

快速开始

# 列出所有候选人
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates?per_page=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

基础 URL

https://gateway.maton.ai/zoho-recruit/{native-api-path}

将 {native-api-path} 替换为实际的 Zoho Recruit API 端点路径。网关会将请求代理到 recruit.zoho.com 并自动注入您的 OAuth token。

认证

所有请求都需要在 Authorization 头中包含 Maton API 密钥：

Authorization: Bearer $MATON_API_KEY

环境变量： 将您的 API 密钥设置为 MATON_API_KEY：

export MATON_API_KEY="YOUR_API_KEY"

获取 API 密钥

在 maton.ai 登录或创建账户
访问 maton.ai/settings
复制您的 API 密钥

连接管理

在 https://ctrl.maton.ai 管理您的 Zoho Recruit OAuth 连接。

列出连接

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=zoho-recruit&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

创建连接

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'zoho-recruit'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

获取连接

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

响应：

{
  "connection": {
    "connection_id": "0c9fa9b1-80b6-4caa-afc2-8629fe4d9661",
    "status": "ACTIVE",
    "creation_time": "2026-02-06T07:48:59.474215Z",
    "last_updated_time": "2026-02-06T07:57:52.950167Z",
    "url": "https://connect.maton.ai/?session_token=...",
    "app": "zoho-recruit",
    "metadata": {}
  }
}

在浏览器中打开返回的 url 以完成 OAuth 授权。

删除连接

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

指定连接

如果您有多个 Zoho Recruit 连接，请使用 Maton-Connection 头指定要使用的连接：

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Maton-Connection', '0c9fa9b1-80b6-4caa-afc2-8629fe4d9661')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

如果省略，网关将使用默认（最早的）活动连接。

API 参考

模块

列出所有模块

获取 Zoho Recruit 账户中所有可用模块的列表。

GET /zoho-recruit/recruit/v2/settings/modules

示例：

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/settings/modules')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

候选人

列出候选人

GET /zoho-recruit/recruit/v2/Candidates

查询参数：

参数	类型	默认值	描述
`fields`	string	-	逗号分隔的字段 API 名称
`sort_order`	string	-	`asc` 或 `desc`
`sort_by`	string	-	排序的字段 API 名称
`converted`	string	-	`true`、`false` 或 `both`
`approved`	string	-	`true`、`false` 或 `both`
`page`	integer	1	页码
`per_page`	integer	200	每页记录数（最大 200）

示例：

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates?per_page=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

响应：

{
  "data": [
    {
      "id": "846336000000552208",
      "First_Name": "Christina",
      "Last_Name": "Palaskas",
      "Email": "c.palaskas@example.com",
      "Candidate_Status": "Converted - Employee",
      "Current_Employer": "Chandlers",
      "Current_Job_Title": "Technical Consultant",
      "Experience_in_Years": 3,
      "Skill_Set": "Communication, Presentation, Customer service",
      "Candidate_Owner": {
        "name": "Byungkyu Park",
        "id": "846336000000549541"
      }
    }
  ],
  "info": {
    "per_page": 10,
    "count": 1,
    "page": 1,
    "more_records": false
  }
}

根据 ID 获取候选人

GET /zoho-recruit/recruit/v2/Candidates/{record_id}

示例：

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates/846336000000552208')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

搜索候选人

GET /zoho-recruit/recruit/v2/Candidates/search?criteria={criteria}

查询参数：

参数	类型	描述
`criteria`	string	搜索条件（例如 `(Last_Name:contains:Smith)`）
`email`	string	按邮箱搜索
`phone`	string	按电话搜索
`word`	string	全局单词搜索
`page`	integer	页码
`per_page`	integer	每页记录数

搜索操作符：

文本：equals、not_equal、starts_with、ends_with、contains、not_contains、in
日期/数字：equals、not_equal、greater_than、less_than、greater_equal、less_equal、between

示例：

python <<'EOF'
import urllib.request, os, json
import urllib.parse
criteria = urllib.parse.quote('(Candidate_Status:equals:Active)')
req = urllib.request.Request(f'https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates/search?criteria={criteria}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

创建候选人

POST /zoho-recruit/recruit/v2/Candidates Content-Type: application/json

{ "data": [ { "First_Name": "John", "Last_Name": "Doe", "Email": "john.doe@example.com", "Phone": "555-123-4567", "Current_Job_Title": "Software Engineer" } ] }

示例：

python <<'EOF'
import urllib.request, os, json
data = json.dumps({
    "data": [{
        "First_Name": "John",
        "Last_Name": "Doe",
        "Email": "john.doe@example.com",
        "Phone": "555-123-4567"
    }]
}).encode()
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

响应：

{
  "data": [
    {
      "code": "SUCCESS",
      "status": "success",
      "message": "record added",
      "details": {
        "id": "846336000000600001",
        "Created_Time": "2026-02-06T10:00:00-08:00",
        "Created_By": {
          "name": "User Name",
          "id": "846336000000549541"
        }
      }
    }
  ]
}

更新候选人

PUT /zoho-recruit/recruit/v2/Candidates/{record_id}
Content-Type: application/json{
  "data": [
    {
      "Current_Job_Title": "Senior Software Engineer"
    }
  ]
}

示例：

python <<'EOF'
import urllib.request, os, json
data = json.dumps({
    "data": [{
        "Current_Job_Title": "Senior Software Engineer"
    }]
}).encode()
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates/846336000000552208', data=data, method='PUT')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

删除候选人

DELETE /zoho-recruit/recruit/v2/Candidates?ids={record_id1},{record_id2}

职位空缺

列出职位空缺

GET /zoho-recruit/recruit/v2/Job_Openings

示例：

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/Job_Openings?per_page=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

响应：

{
  "data": [
    {
      "id": "846336000000552093",
      "Posting_Title": "Senior Accountant (Sample)",
      "Job_Opening_Status": "Waiting for approval",
      "Date_Opened": "2026-01-21",
      "Target_Date": "2026-02-20",
      "Industry": "Accounting",
      "City": "Tallahassee",
      "No_of_Candidates_Hired": 0,
      "No_of_Candidates_Associated": 0
    }
  ],
  "info": {
    "per_page": 10,
    "count": 1,
    "page": 1,
    "more_records": false
  }
}

根据 ID 获取职位空缺

GET /zoho-recruit/recruit/v2/Job_Openings/{record_id}

创建职位空缺

POST /zoho-recruit/recruit/v2/Job_Openings Content-Type: application/json

{ "data": [ { "Posting_Title": "Software Engineer", "Job_Opening_Status": "In-progress", "Date_Opened": "2026-02-01", "Target_Date": "2026-03-01" } ] }

更新职位空缺

PUT /zoho-recruit/recruit/v2/Job_Openings/{record_id}
Content-Type: application/json

删除职位空缺

DELETE /zoho-recruit/recruit/v2/Job_Openings?ids={record_id1},{record_id2}

面试

列出面试

GET /zoho-recruit/recruit/v2/Interviews

示例：

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/Interviews?per_page=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

根据 ID 获取面试

GET /zoho-recruit/recruit/v2/Interviews/{record_id}

创建面试

POST /zoho-recruit/recruit/v2/Interviews
Content-Type: application/json{
  "data": [
    {
      "Interview_Name": "Technical Interview",
      "Candidate_Name": {"id": "846336000000552208"},
      "Posting_Title": {"id": "846336000000552093"},
      "Start_DateTime": "2026-02-10T10:00:00-08:00",
      "End_DateTime": "2026-02-10T11:00:00-08:00"
    }
  ]
}

部门

列出部门

GET /zoho-recruit/recruit/v2/Departments

示例：

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/Departments?per_page=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

申请

列出申请

GET /zoho-recruit/recruit/v2/Applications

通用记录操作

所有模块都支持相同的 CRUD 操作：

# 列出记录
GET /zoho-recruit/recruit/v2/{module_api_name}
# 根据 ID 获取记录
GET /zoho-recruit/recruit/v2/{module_api_name}/{record_id}
# 创建记录
POST /zoho-recruit/recruit/v2/{module_api_name}
# 更新记录
PUT /zoho-recruit/recruit/v2/{module_api_name}/{record_id}
# 删除记录
DELETE /zoho-recruit/recruit/v2/{module_api_name}?ids={id1},{id2}# 搜索记录
GET /zoho-recruit/recruit/v2/{module_api_name}/search?criteria={criteria}

可用模块

模块	API 名称	描述
Candidates	`Candidates`	职位候选人
Job Openings	`Job_Openings`	空缺职位
Applications	`Applications`	职位申请
Interviews	`Interviews`	已安排的面试
Departments	`Departments`	公司部门
Clients	`Clients`	客户公司
Contacts	`Contacts`	联系人
Campaigns	`Campaigns`	招聘活动
Referrals	`Referrals`	员工推荐
Tasks	`Tasks`	待办事项
Events	`Events`	日历事件
Vendors	`Vendors`	外部供应商

分页

Zoho Recruit 使用基于页码的分页：

GET /zoho-recruit/recruit/v2/{module_api_name}?page=1&per_page=200

page: 页码（默认：1）
per_page: 每页记录数（默认：200，最大：200）

响应包含分页信息：

{
  "data": [...],
  "info": {
    "per_page": 200,
    "count": 50,
    "page": 1,
    "more_records": false
  }
}

代码示例

JavaScript

const response = await fetch(
  'https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates?per_page=10',
  {
    headers: {
      'Authorization': Bearer ${process.env.MATON_API_KEY}
    }
  }
);
const data = await response.json();

Python

import os
import requestsresponse = requests.get(
    'https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates',
    headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'},
    params={'per_page': 10}
)
data = response.json()

注意事项

记录 ID 是数字字符串（例如 846336000000552208）
GET 请求最多 200 条记录
POST/PUT 请求最多 100 条记录
DELETE 请求最多 100 条记录
模块 API 名称区分大小写（例如 Job_Openings，不是 job_openings）
Last_Name 对于候选人是必填字段
日期格式：yyyy-MM-dd
DateTime 格式：yyyy-MM-ddTHH:mm:ss±HH:mm（ISO 8601）
查找字段使用包含 id 和可选 name 的 JSON 对象
重要：使用 curl 命令时，当 URL 包含特殊字符时使用 curl -g
重要：当将 curl 输出通过管道传递给 jq 或其他命令时，$MATON_API_KEY 等环境变量在某些 shell 环境中可能无法正确展开

错误处理

状态码	含义
400	缺少 Zoho Recruit 连接或无效请求
401	无效或缺少 Maton API 密钥
429	请求速率受限
4xx/5xx	Zoho Recruit API 的直通错误

常见错误码

代码	描述
INVALID_DATA	无效字段值
MANDATORY_NOT_FOUND	必填字段缺失
DUPLICATE_DATA	检测到重复记录
INVALID_MODULE	无效模块 API 名称
NO_PERMISSION	权限不足

故障排除：API 密钥问题

检查是否设置了 MATON_API_KEY 环境变量：

echo $MATON_API_KEY

通过列出连接验证 API 密钥是否有效：

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

故障排除：无效应用名称

确保您的 URL 路径以 zoho-recruit 开头。例如：

正确：https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates
错误：https://gateway.maton.ai/recruit/v2/Candidates

资源

Access the Zoho Recruit API with managed OAuth authentication. Manage candidates, job openings, interviews, applications, and recruitment workflows with full CRUD operations.

Quick Start

# List all candidates
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates?per_page=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Base URL

https://gateway.maton.ai/zoho-recruit/{native-api-path}

Replace {native-api-path} with the actual Zoho Recruit API endpoint path. The gateway proxies requests to recruit.zoho.com and automatically injects your OAuth token.

Authentication

All requests require the Maton API key in the Authorization header:

Authorization: Bearer $MATON_API_KEY

Environment Variable: Set your API key as MATON_API_KEY:

export MATON_API_KEY="YOUR_API_KEY"

Getting Your API Key

Sign in or create an account at maton.ai
Go to maton.ai/settings
Copy your API key

Connection Management

Manage your Zoho Recruit OAuth connections at https://ctrl.maton.ai.

List Connections

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=zoho-recruit&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Create Connection

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'zoho-recruit'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Get Connection

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Response:

{
  "connection": {
    "connection_id": "0c9fa9b1-80b6-4caa-afc2-8629fe4d9661",
    "status": "ACTIVE",
    "creation_time": "2026-02-06T07:48:59.474215Z",
    "last_updated_time": "2026-02-06T07:57:52.950167Z",
    "url": "https://connect.maton.ai/?session_token=...",
    "app": "zoho-recruit",
    "metadata": {}
  }
}

Open the returned url in a browser to complete OAuth authorization.

Delete Connection

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Specifying Connection

If you have multiple Zoho Recruit connections, specify which one to use with the Maton-Connection header:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Maton-Connection', '0c9fa9b1-80b6-4caa-afc2-8629fe4d9661')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

If omitted, the gateway uses the default (oldest) active connection.

API Reference

Modules

List All Modules

Get a list of all available modules in your Zoho Recruit account.

GET /zoho-recruit/recruit/v2/settings/modules

Example:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/settings/modules')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Candidates

List Candidates

GET /zoho-recruit/recruit/v2/Candidates

Query Parameters:

Parameter	Type	Default	Description
`fields`	string	-	Comma-separated field API names
`sort_order`	string	-	`asc` or `desc`
`sort_by`	string	-	Field API name to sort by
`converted`	string	-	`true`, `false`, or `both`
`approved`	string	-	`true`, `false`, or `both`
`page`	integer	1	Page number
`per_page`	integer	200	Records per page (max 200)

Example:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates?per_page=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Response:

{
  "data": [
    {
      "id": "846336000000552208",
      "First_Name": "Christina",
      "Last_Name": "Palaskas",
      "Email": "c.palaskas@example.com",
      "Candidate_Status": "Converted - Employee",
      "Current_Employer": "Chandlers",
      "Current_Job_Title": "Technical Consultant",
      "Experience_in_Years": 3,
      "Skill_Set": "Communication, Presentation, Customer service",
      "Candidate_Owner": {
        "name": "Byungkyu Park",
        "id": "846336000000549541"
      }
    }
  ],
  "info": {
    "per_page": 10,
    "count": 1,
    "page": 1,
    "more_records": false
  }
}

Get Candidate by ID

GET /zoho-recruit/recruit/v2/Candidates/{record_id}

Example:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates/846336000000552208')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Search Candidates

GET /zoho-recruit/recruit/v2/Candidates/search?criteria={criteria}

Query Parameters:

Parameter	Type	Description
`criteria`	string	Search criteria (e.g., `(Last_Name:contains:Smith)`)
`email`	string	Search by email
`phone`	string	Search by phone
`word`	string	Global word search
`page`	integer	Page number
`per_page`	integer	Records per page

Search Operators:

Text: equals, not_equal, starts_with, ends_with, contains, not_contains, in
Date/Number: equals, not_equal, greater_than, less_than, greater_equal, less_equal, between

Example:

python <<'EOF'
import urllib.request, os, json
import urllib.parse
criteria = urllib.parse.quote('(Candidate_Status:equals:Active)')
req = urllib.request.Request(f'https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates/search?criteria={criteria}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Create Candidate

POST /zoho-recruit/recruit/v2/Candidates Content-Type: application/json

{ "data": [ { "First_Name": "John", "Last_Name": "Doe", "Email": "john.doe@example.com", "Phone": "555-123-4567", "Current_Job_Title": "Software Engineer" } ] }

Example:

python <<'EOF'
import urllib.request, os, json
data = json.dumps({
    "data": [{
        "First_Name": "John",
        "Last_Name": "Doe",
        "Email": "john.doe@example.com",
        "Phone": "555-123-4567"
    }]
}).encode()
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Response:

{
  "data": [
    {
      "code": "SUCCESS",
      "status": "success",
      "message": "record added",
      "details": {
        "id": "846336000000600001",
        "Created_Time": "2026-02-06T10:00:00-08:00",
        "Created_By": {
          "name": "User Name",
          "id": "846336000000549541"
        }
      }
    }
  ]
}

Update Candidate

PUT /zoho-recruit/recruit/v2/Candidates/{record_id}
Content-Type: application/json{
  "data": [
    {
      "Current_Job_Title": "Senior Software Engineer"
    }
  ]
}

Example:

python <<'EOF'
import urllib.request, os, json
data = json.dumps({
    "data": [{
        "Current_Job_Title": "Senior Software Engineer"
    }]
}).encode()
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates/846336000000552208', data=data, method='PUT')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Delete Candidates

DELETE /zoho-recruit/recruit/v2/Candidates?ids={record_id1},{record_id2}

Job Openings

List Job Openings

GET /zoho-recruit/recruit/v2/Job_Openings

Example:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/Job_Openings?per_page=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Response:

{
  "data": [
    {
      "id": "846336000000552093",
      "Posting_Title": "Senior Accountant (Sample)",
      "Job_Opening_Status": "Waiting for approval",
      "Date_Opened": "2026-01-21",
      "Target_Date": "2026-02-20",
      "Industry": "Accounting",
      "City": "Tallahassee",
      "No_of_Candidates_Hired": 0,
      "No_of_Candidates_Associated": 0
    }
  ],
  "info": {
    "per_page": 10,
    "count": 1,
    "page": 1,
    "more_records": false
  }
}

Get Job Opening by ID

GET /zoho-recruit/recruit/v2/Job_Openings/{record_id}

Create Job Opening

POST /zoho-recruit/recruit/v2/Job_Openings Content-Type: application/json

{ "data": [ { "Posting_Title": "Software Engineer", "Job_Opening_Status": "In-progress", "Date_Opened": "2026-02-01", "Target_Date": "2026-03-01" } ] }

Update Job Opening

PUT /zoho-recruit/recruit/v2/Job_Openings/{record_id}
Content-Type: application/json

Delete Job Openings

DELETE /zoho-recruit/recruit/v2/Job_Openings?ids={record_id1},{record_id2}

Interviews

List Interviews

GET /zoho-recruit/recruit/v2/Interviews

Example:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/Interviews?per_page=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Get Interview by ID

GET /zoho-recruit/recruit/v2/Interviews/{record_id}

Create Interview

POST /zoho-recruit/recruit/v2/Interviews
Content-Type: application/json{
  "data": [
    {
      "Interview_Name": "Technical Interview",
      "Candidate_Name": {"id": "846336000000552208"},
      "Posting_Title": {"id": "846336000000552093"},
      "Start_DateTime": "2026-02-10T10:00:00-08:00",
      "End_DateTime": "2026-02-10T11:00:00-08:00"
    }
  ]
}

Departments

List Departments

GET /zoho-recruit/recruit/v2/Departments

Example:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-recruit/recruit/v2/Departments?per_page=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Applications

List Applications

GET /zoho-recruit/recruit/v2/Applications

Generic Record Operations

All modules support the same CRUD operations:

# List records
GET /zoho-recruit/recruit/v2/{module_api_name}
# Get record by ID
GET /zoho-recruit/recruit/v2/{module_api_name}/{record_id}
# Create records
POST /zoho-recruit/recruit/v2/{module_api_name}
# Update records
PUT /zoho-recruit/recruit/v2/{module_api_name}/{record_id}
# Delete records
DELETE /zoho-recruit/recruit/v2/{module_api_name}?ids={id1},{id2}# Search records
GET /zoho-recruit/recruit/v2/{module_api_name}/search?criteria={criteria}

Available Modules

Module	API Name	Description
Candidates	`Candidates`	Job candidates
Job Openings	`Job_Openings`	Open positions
Applications	`Applications`	Job applications
Interviews	`Interviews`	Scheduled interviews
Departments	`Departments`	Company departments
Clients	`Clients`	Client companies
Contacts	`Contacts`	Contact persons
Campaigns	`Campaigns`	Recruitment campaigns
Referrals	`Referrals`	Employee referrals
Tasks	`Tasks`	To-do items
Events	`Events`	Calendar events
Vendors	`Vendors`	External vendors

Pagination

Zoho Recruit uses page-based pagination:

GET /zoho-recruit/recruit/v2/{module_api_name}?page=1&per_page=200

page: Page number (default: 1)
per_page: Records per page (default: 200, max: 200)

Response includes pagination info:

{
  "data": [...],
  "info": {
    "per_page": 200,
    "count": 50,
    "page": 1,
    "more_records": false
  }
}

Code Examples

JavaScript

const response = await fetch(
  'https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates?per_page=10',
  {
    headers: {
      'Authorization': Bearer ${process.env.MATON_API_KEY}
    }
  }
);
const data = await response.json();

Python

import os
import requestsresponse = requests.get(
    'https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates',
    headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'},
    params={'per_page': 10}
)
data = response.json()

Notes

Record IDs are numeric strings (e.g., 846336000000552208)
Maximum 200 records per GET request
Maximum 100 records per POST/PUT request
Maximum 100 records per DELETE request
Module API names are case-sensitive (e.g., Job_Openings, not job_openings)
Last_Name is mandatory for Candidates
Date format: yyyy-MM-dd
DateTime format: yyyy-MM-ddTHH:mm:ss±HH:mm (ISO 8601)
Lookup fields use JSON objects with id and optionally name
IMPORTANT: When using curl commands, use curl -g when URLs contain special characters
IMPORTANT: When piping curl output to jq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments

Error Handling

Status	Meaning
400	Missing Zoho Recruit connection or invalid request
401	Invalid or missing Maton API key
429	Rate limited
4xx/5xx	Passthrough error from Zoho Recruit API

Common Error Codes

Code	Description
INVALID_DATA	Invalid field value
MANDATORY_NOT_FOUND	Required field missing
DUPLICATE_DATA	Duplicate record detected
INVALID_MODULE	Invalid module API name
NO_PERMISSION	Insufficient permissions

Troubleshooting: API Key Issues

Check that the MATON_API_KEY environment variable is set:

echo $MATON_API_KEY

Verify the API key is valid by listing connections:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Troubleshooting: Invalid App Name

Ensure your URL path starts with zoho-recruit. For example:

Correct: https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates
Incorrect: https://gateway.maton.ai/recruit/v2/Candidates

Resources

数据来源：ClawHub ↗ · 中文优化：龙虾技能库

OpenClaw 技能定制 / 插件定制 / 私有工作流定制

免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制

了解定制服务

License

运行时依赖

版本

安装命令 点击复制

技能文档

快速开始

基础 URL

认证

获取 API 密钥

连接管理

列出连接

创建连接

获取连接

删除连接

指定连接

API 参考

模块

列出所有模块

候选人

列出候选人

根据 ID 获取候选人

搜索候选人

创建候选人

更新候选人

删除候选人

职位空缺

列出职位空缺

根据 ID 获取职位空缺

创建职位空缺

更新职位空缺

删除职位空缺

面试

列出面试

根据 ID 获取面试

创建面试

部门

列出部门

申请

列出申请

通用记录操作

可用模块

分页

代码示例

JavaScript

Python

注意事项

错误处理

常见错误码

故障排除：API 密钥问题

故障排除：无效应用名称

资源

Quick Start

Base URL

Authentication

Getting Your API Key

Connection Management

List Connections

Create Connection

Get Connection

Delete Connection

Specifying Connection

API Reference

Modules

List All Modules

Candidates

List Candidates

Get Candidate by ID

Search Candidates

Create Candidate

Update Candidate

Delete Candidates

Job Openings

List Job Openings

Get Job Opening by ID

Create Job Opening

Update Job Opening

Delete Job Openings

Interviews

List Interviews

Get Interview by ID

安装命令点击复制