Manage your apps

Learn how to create and manage REST API apps


The purpose of a REST API app is to generate your OAuth 2.0 credentials for the sandbox and live environments.


  • To show your live app information, toggle to Live.
  • To go live, select My Account to enable features for your PayPal account. Alternatively, go directly to the My Account page.
  • To make live transactions, you must upgrade to a PayPal business account. To protect your customers and you, secure your credentials.
  • To review your app's call history, click Sandbox > API Calls or Live > API Calls. These dashboards show the transaction date, type, status, amount and other details.

Create or edit sandbox and live apps

You can create or edit an app:

  1. Log into Dashboard and type your PayPal account email and password.
  2. On the My Apps & Credentials page, toggle to Live or Sandbox depending on which kind of app you want to create or edit:

    • To create an app, click Create App in the REST API apps section. Type a name for your app and click Create App.
    • To edit an app, click a link for an app in the App Name column in the REST API apps section. To change the app's name, click the pencil icon, type a name for your app, and click Create App.
  3. Copy and save your API credentials — the client ID and secret for your app — which you exchange for an access token that authorizes your REST API calls.

    Note: To rotate your app secret, click Show and Generate New Secret. After you generate an app secret, you can disable the old secret and enable the new one. Do not disable your app secret if live API calls still use it.
  4. Review or update your app details, which include webhooks and app settings.


    The PayPal REST APIs use webhooks for event notification. Webhooks are HTTP callbacks that receive notification messages for events. To create a webhook, configure a webhook listener and subscribe it to events.

    App settings

    Define your return URL and enable or disable your app feature options.

    • Return URL. Define the website page to which you redirect buyers from the PayPal website. The sandbox return URL can be different from the live return URL.

    • App feature options. Enable or disable app feature options.

      Option Description
      Accept payments

      Accept one-time and subscription payments from PayPal account holders. To configure this option, click Advanced Options.

      You can enable:

      • Future Payments. Use virtual tokens to save customer payment information. Currently only available through the mSDK.

      • Billing agreements. Set up and manage scheduled payments from customers.

      Note: For a live app to accept PayPal payments, you must have a PayPal business account. Also, live apps can accept PayPal payments in only certain countries.

      Issue invoices for and manage balances and enable custom net payment terms.


      Send batch payments to multiple PayPal accounts at once. You can vary the amount by recipient and deliver payments by phone number or email.


      Use the Disputes API to list disputes, provide evidence for a dispute, accept claims, show dispute details, and appeal disputes.

      PayPal Here

      Process swiped/card-present card transactions. To develop a custom PayPal Here app, use the PayPal Here SDKs.

      Connect with PayPal

      Enable your customers to use their PayPal login.

      • Log in with PayPal is not available for Mobile SDK apps.

      • You can create an app that leverages this feature if you have a PayPal account in your country. However, some countries restrict payments with live REST API credentials. If you are a non-U.S. developer, see the FAQs.

      • In the live environment, send your live app and its information to to have customers share data in addition to their full name with you. Include the app's client ID, description, how your app uses Log in with PayPal, list of scope attributes to enable, and how the app uses each scope attribute. Approval is delayed until PayPal receives all information. The app review process typically takes from seven to ten days.

      To enable Log in with PayPal, click Advanced Options and provide the information for the sandbox or live environment.

      Select scope attributes for OpenID connect (OAuth) protocol. You are requesting your customers to share this data with you.

      • Personal Profile. Full name and email.

      • Address. Street address, city, state, country, and postal code.

      • Account Information. Account verification status and PayPal account ID (payer ID).

      • Links shown on customer consent page. Privacy policy URL and user agreement URL.

      • Additional PayPal permissions. Enable customers who have not yet confirmed their email with PayPal to log in to your app.

      Transaction Search

      Access your PayPal transaction history.

  5. Save your app.

Additional information