Fields Reference

This page documents all fields in a delegation record and their constraints.

Delegation Fields

Field	Description	Required
Type	User-to-User or Company-wide	Yes
Delegator	The user who grants access to their travelers	User-to-User: Yes, Company-wide: Optional
Delegate	The user who receives access	Yes
Company	The company context for this delegation	Yes
Scopes	Permission scopes granted	Yes (at least one)
Status	Whether the delegation is active or inactive	Yes
Created	When the delegation was created	Automatic

Delegation Types

Type	Delegator	Delegate Access
User-to-User	Required - specific user	Access to the delegator's travelers only
Company-wide (with delegators)	Optional - specific users	Access to listed delegators' travelers
Company-wide (unrestricted)	Not set	Access to any user's travelers in the company via search

Uniqueness

For user-to-user delegations, the combination of delegator, delegate, and company must be unique. You cannot create duplicate delegations for the same user pair in the same company.

For company-wide delegations without a specific delegator, only one such delegation can exist per delegate per company.

If you need to change the scopes, edit the existing delegation instead.

Default Values

Field	Default
Type	User-to-User
Scopes	View Travelers, Create Bookings, View Bookings
Status	Active

Validation Rules

Rule	Error Message
Delegator and delegate are the same user	"Cannot delegate to yourself"
Delegation already exists for this pair	"Delegation already exists"
User not active in the company (user-to-user)	"User not found or not active in company"
No scopes selected	"At least one scope is required"

Scopes Reference - Permission scope details
Creating Delegations - How to create delegations

Fields Reference

Fields Reference

Delegation Fields

Delegation Types

Uniqueness

Default Values

Validation Rules

Related Topics

On this page