Skip to main content
This topic describes what an Enterprise Account is and the API capabilities that Enterprise Account provides.

​
What is an Enterprise Account

An Enterprise Account is an account that an organization can manage. The organization manages the entire account lifecycle, including create, modify, disable, and enable operations. For more details, see DingTalk User Guide - Enterprise Account introduction. The following two types are currently available:
  • single sign-on account: Sign in to DingTalk using the existing account system within the organization. Account management is performed outside DingTalk.
  • DingTalk Enterprise Account: An Enterprise Account created and managed within DingTalk.

​
How to enable Enterprise Account

This feature is currently in gray release. If your organization has not enabled it, submit a trial application first.

​
API capabilities provided by Enterprise Account

Enterprise Account provides a rich set of open API capabilities. Developers can use APIs to integrate Enterprise Account with the organization’s business systems.
APIDescriptionNew specification (new Server API)Legacy specification (Server API)
Create an Enterprise Account userCreates a new Enterprise Account user.-Create an Enterprise Account user Note The documentation has been moved to the historical documentation directory. - If you have not used this API, we recommend that you select Create an SSO Enterprise Account, Create a DingTalk self-built Enterprise Account, or Invite an Enterprise Account from another organization to join based on the account type. - If you have already used this API, evaluate whether to switch to the recommended API based on your actual situation.
Create an SSO Enterprise AccountCreates a new SSO Enterprise Account user.-Create an SSO Enterprise Account
Create a DingTalk self-built Enterprise AccountCreates a new DingTalk self-built Enterprise Account user.-Create a DingTalk self-built Enterprise Account
Invite an Enterprise Account from another organization to joinInvites an Enterprise Account from another organization to join.-Invite an Enterprise Account from another organization to join
Update Enterprise Account user informationUpdates information for the specified Enterprise Account user.-Update Enterprise Account user information
Query Enterprise Account user detailsRetrieves detailed information about the specified Enterprise Account user.-Query Enterprise Account user details
Get department Enterprise Account user detailsRetrieves detailed user information within the specified department.-Get department Enterprise Account user details
Query an Enterprise Account user by mobile numberRetrieves the userId of an Enterprise Account user by mobile number.-Query an Enterprise Account user by mobile number
Enable an Enterprise AccountEnables the specified Enterprise Account.Enable an Enterprise Account-
Disable an Enterprise AccountDisables the specified Enterprise Account.Disable an Enterprise Account-
Force sign-out of an Enterprise AccountForces sign-out of the specified Enterprise Account.Force sign-out of an Enterprise Account-
Query the status of an Enterprise AccountQueries the enabled status of a specified Enterprise Account.Query the status of an Enterprise Account-
Authorize an Enterprise Account to join multiple organizationsAuthorizes an Enterprise Account to join multiple organizations.Authorize an Enterprise Account to join multiple organizations-
Query the organizations owned by an Enterprise AccountQueries the organizations in which an Enterprise Account holds the creator identity, and retrieves information about those organizations.Query the organizations owned by an Enterprise Account-
Transfer Enterprise Account Super Admin (creator)Transfers ownership of an organization owned by one Enterprise Account in the current organization to another Enterprise Account. If the receiving account is not in the organization, it joins automatically.Transfer Enterprise Account Super Admin (creator)-
Query the original dingId based on the migrated dingIdQueries the original dingId based on the migrated dingId.Query the original dingId based on the migrated dingId-
Query the original unionId based on the migrated unionIdQueries the original unionId based on the migrated unionId.Query the original unionId based on the migrated unionId-
Query the migrated dingId based on the original dingIdQueries the migrated dingId based on the original dingId.Query the migrated dingId based on the original dingId-
Query the migrated unionId based on the original unionIdQueries the migrated unionId based on the original unionId.Query the migrated unionId based on the original unionId-

​
Glossary

​
Organization Code

Because an Enterprise Account Belongs to an organization, you must enter the Organization Code when signing in to tell DingTalk which organization to sign in to. The Organization Code is the unique identifier of an organization that uses Enterprise Account. When an organization enables the Enterprise Account feature, DingTalk assigns a random 8-digit Organization Code by default. Contact your account Admin to view it at DingTalk Admin Console > Settings > Organization Code. The organization Admin can also apply for a more personalized code to make it easier for users in the organization to remember and use.