RahalCorporate
DelegationAdmin Guide

Creating Delegations

How to create user delegation relationships as an administrator

Creating Delegations

This guide walks you through creating delegation relationships between users in the Rahal Dashboard.

Prerequisites

Before creating a delegation:

  • Both users must be active members of the same company
  • You must have the WRITE_DELEGATIONS permission
  • Determine which user should be the delegator (grants access) and which should be the delegate (receives access)

Creating a Single Delegation

  1. Open the Rahal Dashboard
  2. Select the appropriate company from the company switcher
  3. Click Delegations in the sidebar
  4. Click the Create Delegation button

Create delegation drawer with company, users, and scope selection fields

Select the Company

If you have access to multiple companies, select the company where both users belong.

If you're already filtered to a specific company, this field may be pre-filled.

Select the Delegate (Receives Access)

In the "Users Who Will Gain Access" field:

  1. Start typing the user's name or email
  2. Select the user from the dropdown
  3. You can select multiple users to create delegations in bulk

This user will be able to access the delegator's travelers.

Select the Delegator (Grants Access)

In the "Users Granting Access" field:

  1. Start typing the delegator's name or email
  2. Select the user from the dropdown
  3. You can select multiple users to create delegations in bulk

This user's travelers will become accessible to the delegate.

Configure Scopes

Select the permission scopes for this delegation:

ScopeWhen to Include
View TravelersAlmost always - needed to see and select travelers
Manage TravelersWhen delegate should be able to edit traveler profiles
Create BookingsWhen delegate should be able to make bookings
View BookingsWhen delegate should see booking history
Cancel BookingsWhen delegate should be able to cancel bookings

Default scopes are: View Travelers, Create Bookings, View Bookings.

Create the Delegation

Click Create Delegation(s) to save.

If you selected multiple users on either side, multiple delegations will be created for each combination.

Bulk Delegation Creation

The delegation form supports creating multiple delegations at once:

Scenario: One Delegator, Multiple Delegates

An executive wants to grant access to their entire assistant team.

  1. In "Users Who Will Gain Access", select all assistants
  2. In "Users Granting Access", select the executive
  3. Configure scopes
  4. Click Create

Result: One delegation is created for each assistant.

Scenario: Multiple Delegators, One Delegate

A travel coordinator needs access to an entire department's travelers.

  1. In "Users Who Will Gain Access", select the travel coordinator
  2. In "Users Granting Access", select all department members
  3. Configure scopes
  4. Click Create

Result: One delegation is created from each department member to the coordinator.

Scenario: Many-to-Many

Create delegations between multiple users simultaneously.

Be careful with many-to-many creation. If you select 5 delegates and 5 delegators, you'll create 25 delegations (minus self-delegations, which are automatically skipped).

Form Fields Reference

FieldRequiredDescription
CompanyYesThe company context for the delegation
Users Who Will Gain AccessYesThe delegate(s) - users receiving access
Users Granting AccessYesThe delegator(s) - users whose travelers are shared
Delegation ScopesYesAt least one scope must be selected

Validation Rules

The system enforces these rules:

RuleError Message
Delegator and delegate are the same user"Cannot delegate to yourself"
Delegation already exists"Delegation already exists"
User not active in company"User not found or not active in company"
No scopes selected"At least one scope is required"

Self-Delegation Prevention

Users cannot delegate to themselves. If you try to create a delegation where the same user is both delegator and delegate:

  • In single-user selection: An error is shown
  • In bulk selection: The self-delegation is silently skipped

Post-Creation

After creating a delegation:

  1. The delegation appears in the table immediately
  2. It is active by default
  3. The delegate can immediately access the delegator's travelers
  4. No notification is sent automatically (consider informing users manually)

Common Scenarios

Executive Assistant Setup

Goal: Allow an assistant to book travel for an executive.

Configuration:

  • Delegate: Executive Assistant
  • Delegator: Executive
  • Scopes: View Travelers, Create Bookings, View Bookings

Travel Coordinator

Goal: Allow a coordinator to manage all department travel.

Configuration:

  • Delegate: Travel Coordinator
  • Delegators: All department members
  • Scopes: View Travelers, Create Bookings, View Bookings, Cancel Bookings

HR Onboarding

Goal: Allow HR to maintain traveler profiles for new hires.

Configuration:

  • Delegate: HR Staff
  • Delegators: New employees
  • Scopes: View Travelers, Manage Travelers

Manager Oversight

Goal: Allow a manager to view (but not modify) team travel.

Configuration:

  • Delegate: Manager
  • Delegators: Team members
  • Scopes: View Travelers, View Bookings

Verification

After creating a delegation, verify it's working:

  1. Find the delegation in the table
  2. Confirm the status is "Active"
  3. Verify the scopes are correct
  4. Optionally, have the delegate confirm they can see the delegator's travelers

On this page