> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ravenna.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflows

> Use BambooHR workflow actions in Ravenna to check employee time-off balances and create time-off requests directly from tickets and automations.

Use BambooHR actions in workflows to check employee time-off balances and create time-off requests directly from Ravenna.

## Actions

<AccordionGroup>
  <Accordion title="Get Time-off Balance">
    Retrieves the current time-off balance for an employee from BambooHR. Returns balances and usage across all time-off policy types.

    **Output data:**

    * Vacation balance and used hours
    * Sick leave balance and used hours
    * Personal time balance and used hours
    * Jury duty balance and used hours
    * Volunteer time balance and used hours
    * Bereavement leave balance and used hours

    **Common use cases:**

    * Check remaining PTO before approving time-off requests
    * Display balance information in agent responses
    * Validate sufficient balance before creating time-off requests
    * Include balance details in approval workflows
  </Accordion>

  <Accordion title="Create Time-off Request">
    Creates a new time-off request in BambooHR on behalf of an employee. Supports configuring the request type, duration, approver, and notes.

    **Input fields:**

    * `requestType` - Type of time off (Vacation, Sick, Personal, Jury Duty, Volunteer, Bereavement)
    * `amount` - Amount of time off requested
    * `units` - Time unit (Hours or Days)
    * `startTime` - Start date of the time-off period
    * `endTime` - End date of the time-off period
    * `approverId` - Ravenna user ID of the approver
    * `note` - Optional reason or note for the request

    **Output data:**

    * Time-off request ID from BambooHR
    * Employee ID
    * Approver ID

    **Common use cases:**

    * Submit time-off requests from Slack or web tickets
    * Automate PTO submissions after manager approval in Ravenna
    * Create requests as part of onboarding or offboarding workflows
  </Accordion>
</AccordionGroup>

## Semantic fields

Employee data synced from BambooHR is available as semantic fields in workflows. You can reference these fields using dynamic values to personalize workflow actions.

**Available fields:**

* Employee name and email
* Job title
* Department
* Manager
* Hire date
* Employment status

<Callout icon="link" color="#6B7280">
  Learn more about [building workflows](/documentation/automate/workflows/publish)
</Callout>