You are viewing the Apigee Management API reference documentation. For the main product docs, and to search all docs, go to

Create Company

Resource Summary


Content Type

application/json, text/xml





Create Company

Creates a company in an organization.


The company is always created with a status of active. To set the status explicitly, use Set the Status of a Company.


The attributes in the sample payload below apply to company configuration in monetization. For non-monetized companies, you need send only name and displayName.


Note: Do not set the company name to 0 (number or string). This value is not supported and will cause unexpected results.


To set the company's billing type (PREPAID to POSTPAID), make sure the organization profile is configured to support your setting (for example, set to accept BOTH). See Edit the organization profile.


Resource URL /organizations/{org_name}/companies

Header Parameters

Name Values Description

Specify the Content-Type as application/json or text/xml.

Request Body

Name Description Default Required?
name Name of the company to be created. See the naming restrictions. N/A Yes
displayName Display name of the company to be created. N/A Yes
attributes Name/value formatted attributes used to extend the default company profile.

Note: With Apigee Edge for Public Cloud, the custom attribute limit is 18.

N/A No

org_name Mention the organization name true

HTTP Basic

OAuth 2.0



Make a request and see the response.

Make a request and see the response.

Make a request and see the response.


Help or comments?

  • If something's not working: Ask the Apigee Community or see Apigee Support.
  • If something's wrong with the docs: Click the "Send Feedback" button.
    (Incorrect? Unclear? Broken link? Typo?)