dingtalk-contact

Fetch DingTalk users, departments, roles, and external contacts via API endpoints.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/farrrr/dingtalk-openapi-skills --skill dingtalk-contact-farrrr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dingtalk-contact
Source: https://github.com/farrrr/dingtalk-openapi-skills/tree/main/dingtalk-skills/skills/dingtalk-contact
Command: npx skills add https://github.com/farrrr/dingtalk-openapi-skills --skill dingtalk-contact-farrrr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

DingTalk directory data is scattered across endpoints and needs orchestration to retrieve users, departments, roles, and external contacts efficiently. This Skill centralizes access to the DingTalk contact API, enabling consistent, governance-friendly lookups and directory management.

Core Features & Use Cases

  • Query users by userId, mobile, or unionId
  • Retrieve department structures, lists, and parent relationships
  • List and inspect roles and external contacts within the enterprise
  • Support both traditional oapi/v1 endpoints and newer api.dingtalk.com endpoints for comprehensive coverage

Quick Start

Look up a user by userId, fetch department details, and list external contacts from DingTalk using the appropriate API endpoints.

Frequently Asked Questions about dingtalk-contact

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

FAQPage Schema
How do I query DingTalk directory data for users, departments, and roles?

You can query DingTalk directory data by fetching users, departments, and roles via appropriate API endpoints. This centralizes access for consistent, governance-friendly enterprise lookups and directory management.

Can I look up a DingTalk user by userId, mobile, or unionId?

Yes, you can look up a DingTalk user by userId, mobile, or unionId. The skill identifies and fetches user data from DingTalk using the appropriate API endpoints to resolve specific user information.

How do I retrieve department structures and parent relationships in DingTalk?

To retrieve DingTalk department structures and parent relationships, use the skill to fetch department lists and details. It supports both traditional oapi/v1 endpoints and newer api.dingtalk.com endpoints.

Does this skill support listing external contacts from DingTalk?

Yes, listing external contacts from DingTalk is supported. The skill locates external contacts within the enterprise using both legacy and v1.0 APIs to ensure comprehensive directory coverage.

What is the best way to orchestrate DingTalk contact API endpoints for enterprise lookups?

The best way to orchestrate DingTalk contact API endpoints is using a centralized skill that supports openapi-based authentication. It resolves userIds, lists department structures, and inspects roles efficiently.

Do I need openapi-based authentication to fetch DingTalk directory data?

Yes, openapi-based authentication is required to fetch DingTalk directory data. The skill uses this authentication method to access both old and new endpoints for users, departments, roles, and external contacts.