See api-docs Menu
  1. Home >
  2. API >
  3. v1-v3 >
  4. Accounts API >
  5. Create Account

Create Account

Creates a new child account. API requests require authentication and reseller privilege.

Resource URL

https://api.onelogin.com/api/v1/accounts

Header Parameters

Authorization

required

string

Set to Bearer <access_token>.

Set <access_token> to the access token generated using the Generate Token API.

Generate the access token with the API credential pair created using the scope required to call this API. Call this API using the Manage All scope.

Request Parameters

account

required

object

 Enter the account attributes.

plan

string

 Enter the plan name.

subscription_state

string

 Enter the desired subscription state.

enforce_user_limit

boolean

 Choose whether to enforce a user limit.

orgsize

integer

 Enter the size of the organization (defaults to 1 if not provided).

from

string

 This field is used internally for specific partner signups.

email_activation

boolean

 Choose whether to use email activation for users of this account.

Sample Response

  • 201 Created
  • 200 OK
  • 404 Precondition Failed
  • 406 Not Acceptable
  • 404 Element Not Found
  • 404 Insufficient Privileges
This request generates no response.
Provides account XML and email activation if required.
Missing required account parameters
Validation failed (see error XML for details)
Related resources not found (Rare)
API requests require authentication and reseller privilege.

Sample cURL Request

Try it out with a test account first: Start off with using this cURL request with a test OneLogin account and API key. Once you’ve familiarized yourself with the API’s behavior, switch over to using your production OneLogin account and API key.

Be sure to replace placeholder values surrounded by { } with actual values.

curl -u {api_key}:x -X POST -H "Content-Type: application/xml" \ https://api.onelogin.com/api/v1/accounts

Have a Question?

Found a problem or a bug? Submit a support ticket.

Looking for walkthroughs or how-to guides on OneLogin's user and admin features? Check out the documentation in our Knowledge Base.

Have a product idea or request? Share it with us in our Ideas Portal.