Registering client apps

This pageapplies toApigee andApigee hybrid.

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

To register a new app, from theApps page:

  1. In the Google Cloud console, go to theApigee> Distribution > Apps page.

    Go to Apps

  2. ClickCreate.
  3. Specify theApp Details, as described in the following table:
    FieldDescriptionRequired?
    App NameName of the app. You can't change the name once the app is created. This name is used inApigee API calls.Required
    Display NameDisplay name for the app that appears in the Apigee UI and the developer portal.Optional
    Developer

    Select a developer name from the drop-down.

    Note: For performance reasons, not all developers are displayed in the drop-down. Start typing the developer name or email in the search box, and the drop-down values are automatically refined to match the text you are typing. See alsoRegister app developers.

    Required
    Callback URLTypically specifies the URL of an app that is designated to receive an authorization code on behalf of the client app. This value is not required for all API products.Optional
    NotesDescriptive notes for the app.Optional
    Note: The app details also include an App ID which is only viewable and editable from the API, not the UI. SeeREST Resource: organizations.developers.apps.
  4. Specify theCredentials, including the API key expiration, status, and the associated API products. In theCredentials section, click Add credential and enter the following information:
    FieldDescription
    ExpirySelect an expiration duration or date, or set the API key to never expire.
    ProductsAssociate one or more API products with the API key:
    1. Click Add products.
    2. Select one or more API products from list.Note: At least one API product must be selected.
    3. ClickOK.
    4. ClickAdd.
  5. Set theStatus toApproved orRevoked for each API product. If you added an API product to the credential that requires manual approval, it will showPending approval status. Otherwise, it will showApproved. In this step, you can change the approval status.
    1. From the list ofProducts in theCredentials section, select one or more products from the list.
    2. ClickApprove orRevoke.
  6. ClickCreate.
  7. Find your new app in the list of developer apps and select it.
  8. Click to see theKey (client ID) andSecret (client secret) values.

More information

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

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-19 UTC.