Organizer accounts and teams
============================

Organizer account
-----------------

The basis of all your operations within pretix is your organizer account. It represents an entity that is running
events, for example a company, yourself or any other institution.
Every event belongs to one organizer account and events within the same organizer account are assumed to belong together
in some sense, whereas events in different organizer accounts are completely isolated.

If you want to use the hosted pretix service, you can create an organizer account on our `Get started`_ page. Otherwise,
ask your pretix administrator for access to an organizer account.

You can find out all organizer accounts you have access to by going to your global dashboard (click on the pretix logo
in the top-left corner) and then select "Organizers" from the navigation bar on the left side. Then, choose one of the
organizer accounts presented, if there are multiple of them:

.. thumbnail:: ../../screens/organizer/list.png
   :align: center
   :class: screenshot

This overview shows you all event that belong to the organizer and you have access to:

.. thumbnail:: ../../screens/organizer/event_list.png
   :align: center
   :class: screenshot

With the "Edit" button at the top, next to the organizer account name, you can modify properties of the organizer
account such as its name and display settings for the public profile page of the organizer account:

.. thumbnail:: ../../screens/organizer/edit.png
   :align: center
   :class: screenshot

.. tip::

   The profile page will be shown as ``https://pretix.eu/slug/`` where ``slug`` is to be replaced by the short form of
   the organizer name that you entered during account creation and ``pretix.eu`` is to be replaced by your
   installation's domain name if you are not using our hosted service.

   Instead, you can also use a custom domain for the profile page and your events, for example
   ``https://tickets.example.com/`` if ``example.com`` is a domain that you own. In this case, please contact the pretix
   hosted support or your system administrator to set up the custom domain.

Teams
-----

We don't expect you to work on your events all by yourself and therefore, pretix comes with ways to invite your fellow
team members to access your pretix organizer account. To manage teams, click on the "Teams" link on your organizer
settings page (see above how to find it). This shows you a list of teams that should contain at least one team already:

.. thumbnail:: ../../screens/organizer/team_list.png
   :align: center
   :class: screenshot

If you click on a team name, you get to a page that shows you the current members of the team:

.. thumbnail:: ../../screens/organizer/team_detail.png
   :align: center
   :class: screenshot

You see that there is a list of pretix user accounts (i.e. email addresses), who are part of the team. To add a user to
the team, just enter their email address in the text box next to the "Add" button. If the user already has an account
in the pretix system they will instantly get access to the team. Otherwise, they will be sent an email with an invitation
link that can be used to create an account. This account will then instantly have access to the team. Users can be part
of as many teams as you want.

In the section below, you can also create access tokens for our :ref:`rest-api`. You can read more on this topic in the
section :ref:`rest-auth` of the API documentation.

Next to the team name, you again see a button called "Edit" that allows you to modify the permissions of the team.
Permissions separate into two areas:

* **Organizer permissions** allow actions on the level of an organizer account, in particular:

   * Can create events – To create a new event under this organizer account, users need to have this permission

   * Can change teams and permissions – This permission is required to perform the kind of action you are doing right now.
     Anyone with this permission can assign arbitrary other permissions to themselves, so this is the most powerful
     permission there is to give.

   * Can change organizer settings – This permission is required to perform changes to the settings of the organizer
     account, e.g. its name or display settings.

* **Event permissions** allow actions on the level of an event. You can give the team access to all events

.. thumbnail:: ../../screens/organizer/team_edit.png
   :align: center
   :class: screenshot

.. _Get started: https://pretix.eu/about/en/setup