Create an Organization

You can create organizations in API Hub for Design to add API definitions on behalf of an organization.

Organizations are billed separately from personal accounts. Every organization requires a paid plan based on the number of users and features you want to use. New organizations start with a free 14-day trial, no credit card is required. After the trial period expires, choose a plan that best suits your organization needs.

To create a new organization:

  1. In the sidebar on the left, click Create New and select Create New Organization:

  2. Enter organization details:

    • Organization Account Name – Required. A unique ID for your organization. The organization’s APIs will live under https://app.swaggerhub.com/apis/orgname.

      Requirements:

      • 3 to 20 character long

      • Allowed characters: A..Z a..z 0..9 - _ .

      • Case-insensitive

    • Title – An optional organization title. For example, Acme Inc.

    Note

    All these values can be changed later in the organization settings.

  3. Click Create Organization.

What’s next

Organization-level permissions

  • Allow Designers and Consumers to make APIs and Domains Public

    Specifies whether all members who are designers can make API and domain definition files public.

  • Allow Consumers to Comment on all the APIs & Domains they can access

    Specifies whether all organization members who are consumers can add comments to API and domain files.

  • Allow Organization Designer Role to Share Resources they can access

    Specifies whether designers can grant others access to the resources that those designers can access.

See Resource Roles for more information about organization-level permissions.

See Also

Publication date: