邮箱联系人管理 - 用户令牌（IFeishuUserV1MailContact）

功能描述

飞书邮箱联系人API接口实现了修改、查询、删除等邮箱联系人管理功能。支持用户通过用户访问令牌管理自己的邮箱联系人。

参考文档

• 创建邮箱联系人
• 删除邮箱联系人
• 修改邮箱联系人
• 列出邮箱联系人

函数列表

函数名称	功能描述	认证方式	HTTP 方法
CreateUserMailboxContactAsync	创建邮箱联系人	UserAccessToken	POST
DeleteUserMailboxContactAsync	删除邮箱联系人	UserAccessToken	DELETE
UpdateUserMailboxContactAsync	修改邮箱联系人信息	UserAccessToken	PATCH
GetUserMailboxContactPageListAsync	分页列出邮箱联系人	UserAccessToken	GET

函数详细内容

CreateUserMailboxContactAsync

创建用户邮箱联系人

函数签名

Task<FeishuApiResult<CreateUserMailboxContactResult>?> CreateUserMailboxContactAsync(
    [Path] string user_mailbox_id,
    [Body] CreateUserMailboxContactRequest request,
    CancellationToken cancellationToken = default);

认证 UserAccessToken（用户访问令牌）

参数

参数名	类型	必填	描述	示例
user_mailbox_id	string	✅	用户邮箱地址，作为用户邮箱身份标识。使用 user_access_token 调用时，可使用占位符 me 表示当前授权用户的主邮箱。	user@example.com
request	CreateUserMailboxContactRequest	✅	创建用户邮箱联系人请求对象	-
cancellationToken	CancellationToken	⚪	取消操作令牌对象	default

响应

{
  "code": 0,
  "msg": "success",
  "data": {
    "mail_contact_id": "123",
    "email": "contact@example.com",
    "name": "联系人名称",
    "create_time": "2026-06-03T11:34:00+08:00"
  }
}

说明

• 使用 user_access_token 时，只能创建当前授权用户的邮箱联系人
• 创建的联系人可用于邮件收发时的快速选择

代码示例

var contactApi = feishuApp.GetApi<IFeishuUserV1MailContact>();
var request = new CreateUserMailboxContactRequest
{
    Email = "contact@example.com",
    Name = "联系人名称"
};
var result = await contactApi.CreateUserMailboxContactAsync("me", request);
Console.WriteLine($"联系人创建成功: {result?.Data?.MailContactId}");

---

DeleteUserMailboxContactAsync

删除用户邮箱联系人

函数签名

Task<FeishuNullDataApiResult?> DeleteUserMailboxContactAsync(
    [Path] string user_mailbox_id,
    [Path] string mail_contact_id,
    CancellationToken cancellationToken = default);

认证 UserAccessToken（用户访问令牌）

参数

参数名	类型	必填	描述	示例
user_mailbox_id	string	✅	用户邮箱地址，作为用户邮箱身份标识。使用 user_access_token 调用时，可使用占位符 me 表示当前授权用户的主邮箱。	user@example.com
mail_contact_id	string	✅	邮箱联系人 id	123
cancellationToken	CancellationToken	⚪	取消操作令牌对象	default

响应

{
  "code": 0,
  "msg": "success",
  "data": null
}

说明

• 删除操作不可恢复
• 需要获取邮箱联系人ID，可通过列出邮箱联系人接口获取

代码示例

var contactApi = feishuApp.GetApi<IFeishuUserV1MailContact>();
var result = await contactApi.DeleteUserMailboxContactAsync("me", "123");
Console.WriteLine($"联系人删除结果: {result.Code == 0}");

---

UpdateUserMailboxContactAsync

修改用户邮箱联系人信息

函数签名

Task<FeishuNullDataApiResult?> UpdateUserMailboxContactAsync(
    [Path] string user_mailbox_id,
    [Path] string mail_contact_id,
    [Body] UpdateUserMailboxContactRequest request,
    CancellationToken cancellationToken = default);

认证 UserAccessToken（用户访问令牌）

参数

参数名	类型	必填	描述	示例
user_mailbox_id	string	✅	用户邮箱地址，作为用户邮箱身份标识。使用 user_access_token 调用时，可使用占位符 me 表示当前授权用户的主邮箱。	user@example.com
mail_contact_id	string	✅	邮箱联系人 id	123
request	UpdateUserMailboxContactRequest	✅	更新用户邮箱联系人请求对象	-
cancellationToken	CancellationToken	⚪	取消操作令牌对象	default

响应

{
  "code": 0,
  "msg": "success",
  "data": null
}

说明

• 支持部分更新，仅传递需要修改的字段
• 使用 user_access_token 时，只能修改当前授权用户的邮箱联系人

代码示例

var contactApi = feishuApp.GetApi<IFeishuUserV1MailContact>();
var request = new UpdateUserMailboxContactRequest
{
    Name = "更新后的联系人名称"
};
var result = await contactApi.UpdateUserMailboxContactAsync("me", "123", request);
Console.WriteLine($"联系人更新结果: {result.Code == 0}");

---

GetUserMailboxContactPageListAsync

分页列出用户邮箱联系人

函数签名

Task<FeishuApiPageListResult<MailboxContactInfo>?> GetUserMailboxContactPageListAsync(
    [Path] string user_mailbox_id,
    [Query] int page_size = 20,
    [Query] string? page_token = null,
    CancellationToken cancellationToken = default);

认证 UserAccessToken（用户访问令牌）

参数

参数名	类型	必填	描述	示例
user_mailbox_id	string	✅	用户邮箱地址，作为用户邮箱身份标识。使用 user_access_token 调用时，可使用占位符 me 表示当前授权用户的主邮箱。	user@example.com
page_size	int	⚪	分页大小，即本次请求所返回的信息列表内的最大条目数。默认值：20	20
page_token	string?	⚪	分页标记，第一次请求不填，表示从头开始遍历	-
cancellationToken	CancellationToken	⚪	取消操作令牌对象	default

响应

{
  "code": 0,
  "msg": "success",
  "data": {
    "items": [
      {
        "mail_contact_id": "123",
        "email": "contact@example.com",
        "name": "联系人名称",
        "create_time": "2026-06-03T11:34:00+08:00"
      }
    ],
    "page_token": "evt_xxx",
    "has_more": true
  }
}

说明

• 使用 user_access_token 时，只能列出当前授权用户的邮箱联系人
• 支持分页查询，可通过 page_token 获取下一页数据

代码示例

var contactApi = feishuApp.GetApi<IFeishuUserV1MailContact>();
var result = await contactApi.GetUserMailboxContactPageListAsync("me");
if (result?.Data?.Items != null)
{
    foreach (var contact in result.Data.Items)
    {
        Console.WriteLine($"联系人: {contact.Name} ({contact.Email})");
    }
}