Create an Organization

How to create an organization with the rokka API

Table of Contents

Organizations own Images

Images uploaded to rokka are always owned by an organization, not an individual user. When you create an organization, you automatically become its administrator and can add other users with a set of permissions. Users are identified by their email address.

Create a new Organization

To get started, lets create an organization:

curl -X PUT '' -d '{
    'billing_email' => '',
    'display_name' => 'Test Organization Ltd.'
/** @var \Rokka\Client\User $userClient */ 
$userClient->createOrganization('testorganization', '', 'Test Organization Ltd.');

This creates an organization called "testorganization" and returns a json structure that reflects the submitted data and adds the unique id of your organization.

    "id": "c03683b067927d77973b458e0baa40aa7b5e5418",
    "display_name": "Test Organization Ltd.",
    "name": "testorganization",
    "billing_email": ""

Your organization is now ready to use.

You should not share your personal admin account, and particularly not use it from a web application. Instead, create a separate user for automated tools called e.g. "", then give it write access to your organization. Giving permissions on an organization is explained in the reference.