Create your own Apigee Edge 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>.apigee.net/path/to/resource

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.

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.

On the accounts dashboard, a message shows that Edge is provisioning your organization.

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.

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:

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.