Registering Your Application with Windows Live

Current information about Live Connect is now available in the Windows Live Developer Center. The information in the following sections is provided for legacy purposes only.

To develop with Windows Live Messenger Connect, you must register and obtain a client ID.

Arrow - Step 1 of 3

All programmatic interaction with Windows Live requires a client ID, which uniquely identifies your application to Windows Live. Your application must include the client ID in every request that it sends to the Messenger Connect API Service.

To get ready to register, you must:

  • Decide which application type you want. For more information and help with this decision, see Application Types. If you are going to try both web and desktop applications, you must obtain two separate client IDs. (Sample Messenger Connect web and desktop applications are available; see Running the Getting Started Samples for Messenger Connect.)
  • Obtain a Windows Live ID, which you must have to be able to get a client ID for your application. If you don’t already have a Windows Live ID, the registration process guides you in creating one.
    Note The client ID that you obtain is associated with the specific Windows Live ID that you use during registration, and this association cannot be changed later. We recommend that you create a new Windows Live ID specifically for managing your Windows Live application.

Now you are ready to register your application and get your client ID.

To register your application

  1. Sign in to the Windows Live application management site (
    • If you are a returning user, you see a page that lists your registered applications. Click Add an application on this page.
    • If you are new to the site, you see a page similar to following.
      Add application page from the Portal
  2. Type an application name (for example, "Contoso"). This is the name that users will see in the Windows Live user interface (UI). The application name should include your company name or the name of your web site.
  3. Select an application type from the options that appear next to Application type. For more information, see Application Types.
  4. Provide the following information, depending on the application type you choose:
    • Web application—Provide the domain of your site. You cannot change this domain later. Do not specify a domain that is used for redirection.
      Note that you can create a callback URL in a subdomain of the domain that you registered, for example, This practice is called subdomain wildcarding, and it is enabled by default for all applications.
      If you have multiple domains, you must register separate applications—one for each domain. If you have one domain with subdomains, you can either register separate applications for each subdomain, or register one application that uses the root domain and then use the same client ID on subdomains. When you register multiple applications, each application has its own name and logo.
    • Activity feed—This application type is available only to specific Windows Live partners.
    • Desktop application—Provide the home page URL at which your users can learn more—for example, a page that contains download instructions. You cannot change the domain of the home page URL later. Do not specify a domain that is used for redirection.
  5. Click I accept to accept the Windows Live Terms of Service. This action registers your application. The next screen, shown in the following image, displays the client ID and secret key values for your application. Make a note of these values, because you will need them when you write your application.
    Add application confirmation page from the Portal

To proceed to the next step, go to Downloading the Windows Live SDK.