You can add an organization by sending the POST request to the following URL: /organization.

Permission to run the request: Account Owner, Administrator.

 

Request Headers

ParameterDescription
X-Auth-Account-Url (required)Base URL of the account, e.g. http://myaccount.ispringlearn.com
X-Auth-Email (required)Administrator e-mail address.
X-Auth-Password (required)Administrator password.
X-Name (required)A name of the new organization.
X-Description (optional)A description of the new organization.

After the request has been completed, the system returns the response with Code 201. The body of the response contains ID of the added organization.

 

Possible Response Codes

CodeTextDescription
403Permission deniedYou have no permissions to add organizations.
400Bad RequestThe system failed to process the request, because it did not contain all necessary parameters.
201CreatedA new organization has been added.

Sample Request

POST /organization HTTP/1.1
Host: api.ispringonline.com
X-Auth-Account-Url: http://myaccount.ispringlearn.com
X-Auth-Email: email@email.com
X-Auth-Password: password
X-Name: New Organization
XML

Sample Response

HTTP/1.1 201 Created
Connection: close

<organization_id>
XML