feishu-contact

Search Feishu members, manage departments, and convert open_id, user_id, and union_id.

65|9|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/alextangson/feishu_skills --skill feishu-contact
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feishu-contact
Source: https://github.com/alextangson/feishu_skills/tree/main/feishu-contact
Command: npx skills add https://github.com/alextangson/feishu_skills --skill feishu-contact

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

In Feishu, locating the right team member, navigating the organizational structure, and translating between OpenID, UserID, and UnionID across apps is error-prone and time-consuming. This Skill provides API-guided workflows to search members, fetch and manage departments, and convert between ID systems in one place.

Core Features & Use Cases

  • Member search by email or phone to resolve OpenID/UserID/UnionID for cross-system integrations.
  • Department discovery and creation to reflect org structure in external tools.
  • ID conversion across open_id, user_id, and union_id to synchronize identities for workflows.
  • Use Case: Integrate with an HR system to synchronize employee IDs and departments in Feishu-based tooling.

Quick Start

Ask the skill to search for a member by email or phone and convert their identifiers across OpenID, UserID, and UnionID.

Frequently Asked Questions about feishu-contact

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Feishu user IDs between open_id, user_id, and union_id?

You can convert Feishu user IDs between open_id, user_id, and union_id using the Skill's API-driven batch translation capabilities. It enforces required permissions to securely map identifiers across enterprise app contexts for cross-system integrations.

What is the best way to search for a Feishu member by email or phone?

Searching for Feishu members by email or phone resolves their OpenID, UserID, and UnionID through contact API queries. This locates specific team members and retrieves their cross-system identifiers for external directory management and HR synchronization.

How do I retrieve and create Feishu departments for org structure management?

Feishu department discovery and creation is supported through directory management APIs. You can fetch existing departments or create new ones to reflect your organizational structure within external tools and synchronize enterprise hierarchies.

Do I need specific permissions to use Feishu contact APIs for directory management?

Yes, using Feishu contact APIs for directory management requires specific required_permissions for secure operation. These permissions gate access to searching members, managing departments, and translating IDs across enterprise contexts.

Can I synchronize HR system employee IDs with Feishu identifiers?

You can synchronize HR system employee IDs with Feishu by translating between open_id, user_id, and union_id. This API-driven workflow resolves member identifiers via email or phone search and aligns department structures for HR integration.