Registering client apps

Stay organized with collections Save and categorize content based on your preferences.

You're viewing Apigee X documentation.
View Apigee Edge documentation.

To participate in OAuth 2.0 flows on Apigee, client apps must be registered.

What is registration?

Registration allows Apigee (the authorization server) to uniquely identify your app. When you register your app, you receive back two keys: a client ID and client secret. The app needs these keys when negotiating for access tokens with the authorization server.

Quick steps

If you want to register a new app:

  1. Access the Developer Apps page, as described below.

    To access the Developer Apps page:

    1. Open the Apigee UI.
    2. Select Publish > Apps in the left navigation bar.
    3. Click + App
    4. Fill out the form:
      1. Enter a name and display name for the app.
      2. Select a developer (you can choose one of the default developers or create your own).
      3. (Optional) Enter a callback URL. This is used for "three-legged" OAuth grant type flows. This is where Apigee redirects the user after they complete authentication (login) with the resource server. It has to be a complete URL, so you might enter something like For more about three-legged OAuth, see Implementing the authorization code grant type.
      4. Add an API product. You can select an existing product or create your own.
      5. Skip the custom attributes section for now.
      6. Click Create.
    5. Find your new app in the list of developer apps and select it.
    6. Click Show to see the Consumer ID (client ID) and Consumer Secret (client secret) values.

    More information

    For a more detailed discussion of app registration, see Register apps and manage API keys. If you'd like to know more about the role of API products, see What is an API product?.