User management

Web UI

To invite users using the Temporal Cloud UI:

1. In Temporal Web UI, select Settings in the left portion of the window.
2. On the Settings page, select Create Users in the upper-right portion of the window.
3. On the Create Users page in the Email Addresses box, type or paste one or more email addresses.
4. In Account-Level Role, select a Role. The Role applies to all users whose email addresses appear in Email Addresses.
5. If the account has any Namespaces, they are listed under Grant access to Namespaces. To add a permission, select the checkbox next to a Namespace, and then select a permission. Repeat as needed.
6. When all permissions are assigned, select Send Invite.

tcld

Use the tcld user invite command. Specify the user's email, an account-level role, and optionally one or more Namespace permissions.

Available account roles: admin | developer | read.

Available Namespace permissions: Admin | Write | Read.

tcld user invite \
  --user-email <user@example.com> \
  --account-role <role> \
  --namespace-permission <namespace>=<permission>

You can invite multiple users and assign multiple Namespace permissions in a single request:

tcld user invite \
  --user-email user1@example.com \
  --user-email user2@example.com \
  --account-role developer \
  --namespace-permission ns1=Admin \
  --namespace-permission ns2=Write

Cloud Ops API

You can invite users pragmatically using the Cloud Ops API.

1. Create a connection to your Temporal Service using the Cloud Operations API.
2. Use the CreateUser service to create a user.

The new users receive an email with a link to accept the invitation and complete their setup. The new user must use this link to sign up to be added to your account unless the account has a SAML configuration. If your account has a SAML configuration, the new user can sign in using their existing SAML credentials and be included in the account automatically.

caution

The new user must use the same authentication method they originally signed up with to sign in to Temporal Cloud. If they used single sign-on (SSO), they must use the same SSO provider to sign in to Temporal Cloud. If they used email and password authentication, they must use the same email and password to sign in to Temporal Cloud, and cannot use SSO, even if the underlying email address is the same.