Send Docs Feedback

Note: Most user interface tasks can be performed in Edge Classic or the New Edge experience. For an overview, getting started topics, and release notes specific to the New Edge experience, see the docs.

Creating an Apigee Edge account

You need an account to use Apigee Edge. You can create your own or an administrator can create one for you.

For an overview of Apigee Edge, see What is Apigee Edge?

Create your own Apigee Edge account

Edge provides different levels of accounts, including a free trial. This section describes how to create a free trial account.

Here's a little context about what you'll create, which may help you make a good naming decision. When you create an Edge account, an organization will be provisioned for you with the username you specify. (Make it a good name, because you won't be able to change it). An organization is a container for your API proxies and the environments you deploy them to (you get two environments by default, "test" and "prod"). To make calls to your API proxies in your Edge cloud free trial account, you and your developers use a URL that includes your organization name and an environment name.

For example: http://<your_org_name>-<environment>

You'll also use your organization name in the URL for any calls you make to the Edge management API, as described below in the What's next section.

To create a free trial account and log in:

  1. Go to
  2. Enter the required info.
    • The Username is the name you want for your organization. Use only alphanumeric characters.
      You'll have one opportunity to change this name in the steps below before the organization is created.
  3. Click Create account.
  4. Important: In the email you receive, click the link to verify your email.
  5. After you click the email link, a browser window is opened to the login page ( Log in with the email and password you used to sign up.
  6. After you log in, you're taken to the account dashboard:
  7. Click the API Management / Create & Manage APIs box.
  8. In the Activate dialog that appears, you have one last opportunity to change your organization name.
    • If you want to change the organization name, click the create link, then enter the new org name and click Create.
    • If you want to keep the organization name show, click Activate.
  9. On the accounts dashboard, a message shows that Edge is provisioning your organization.
  10. When the provisioning is complete, click the API Management box again. You're taken to the Edge management UI.

Congratulations! You have a new Edge account and organization. The email used to set up the account is automatically added to the Organization Administrator role. That means you can do just about everything in your organization.

What's next?

Now that you have a new Edge organization, you can get started building API proxies and infrastructure. You can also start using the Edge management API to manage your organization's API proxies and resources.

And now that you're a registered Edge user, you can be added as an administrator to other organizations, where you can create API proxies and manage the API environment according to the role you're assigned. You can also add other Edge users as administrators to your organization. See Managing organization users for more information.


A great way to get familiar with Edge is to run through some tutorials. Why not start with Create your first API proxy?

API proxy development and concepts

For an intro to API proxies and related Edge artifacts, see Video concepts. For a deeper dive into the anatomy of API proxies and proxy development, see the topics starting with Understanding APIs and API proxies.

For a longer, more comprehensive read, check out What is Apigee Edge?

Your organization and credentials in the management API

Using the Edge management API is a slightly advanced topic, but we mention it here because it involves the organization name credentials you've created. Your Edge email and password let you make calls to the Edge management API (since you're automatically an Organization Administrator with permissions to do just about anything). 

For example, say you want to get a list of all your API proxies. You can make that management API call in a number of ways, such as in Postman, with SmartDocs, with cURL, and so on. Here's a cURL example:

$ curl{org_name}/apis -u email:password

On each call, you must specify your organization name and include your Apigee email and password (currently with basic auth). The call above shows how your credentials are passed using cURL. With other API clients, enter your credentials in the appropriate place for basic auth.

Finding your organization name

After you create an organization, you can find its name in a few places:

In the URL of the management UI

In the management UI "Organization" drop-down

Switching to API BaaS and other components

In the management UI, you can switch to API BaaS and other components from the API Management drop-down menu.

Create an Apigee Edge account as an organization administrator

An organization administrator can add a new user account on Apigee Edge. The new user is automatically added to the administrator's organization. For more information, see Managing organization users.


Help or comments?