Connecting Deputy HR to Craveva

Overview

Prerequisites

• Active Deputy account
• Deputy API access (requires subscription)
• API credentials (OAuth)
• Craveva AI account

Step 1: Create Deputy OAuth App

1. Log in to Deputy Developer Portal (developers.deputy.com)
2. Click Create App
3. Fill in application details:
4. Select OAuth scopes:
5. Click Create
6. Copy your credentials:

• - App Name: "Craveva AI Integration"
• - Description: "AI-powered workforce management"
• - Redirect URI: https://api.craveva.ai/oauth/deputy/callback
• - employee: Read employee data
• - timesheet: Read timesheet data
• - schedule: Read schedule data
• - location: Read location data
• - Client ID: Your OAuth client ID
• - Client Secret: Your OAuth client secret

Step 2: Connect Deputy in Craveva

1. Log in to Craveva AI dashboard
2. Navigate to Data Sources → Connect New Data Source
3. Select REST API connector
4. Choose HR & Payroll Systems category
5. Enter connection details:
6. Click Authorize to start OAuth flow
7. Log in to Deputy and grant permissions
8. Once authorized, click Save

• - Name: "Deputy HR"
• - Base URL: https://{your-subdomain}.api.deputy.com
• - Auth Type: OAuth 2.0
• - Client ID: Your Deputy Client ID
• - Client Secret: Your Client Secret
• - Authorization URL: https://once.deputy.com/my/oauth/login
• - Token URL: https://{your-subdomain}.api.deputy.com/v1/oauth/access_token
• - Redirect URI: https://api.craveva.ai/oauth/deputy/callback

Step 3: Configure Endpoints

• Employees: /v1/resource/Employee - Employee data
• Timesheets: /v1/resource/Timesheet - Time tracking
• Schedules: /v1/resource/Schedule - Shift schedules
• Locations: /v1/resource/Location - Business locations
• Rosters: /v1/resource/Roster - Staff rosters

Step 4: Create Deputy Agents

Scheduling Agent

1. Optimize staff schedules
2. Predict staffing needs
3. Balance workloads
4. Reduce overtime costs

Attendance Agent

1. Track attendance patterns
2. Monitor punctuality
3. Identify trends
4. Generate reports

Workforce Analytics Agent

1. Analyze labor costs
2. Track productivity
3. Identify top performers
4. Optimize staffing

Available Data

• Employee information
• Timesheets and attendance
• Schedules and shifts
• Locations and departments
• Rosters and assignments
• Leave requests
• Performance data

Use Cases

Smart Scheduling

• Optimize shift assignments
• Predict staffing needs
• Balance workloads
• Reduce labor costs

Attendance Management

• Track attendance automatically
• Monitor punctuality
• Identify patterns
• Generate reports

Workforce Analytics

• Analyze labor costs
• Track productivity
• Identify trends
• Optimize operations

Troubleshooting

• Verify redirect URI matches
• Check OAuth scopes
• Ensure Deputy account is active
• Try re-authorizing

• Check subdomain in URLs
• Verify API credentials
• Ensure OAuth app is active
• Contact Deputy support

Next Steps

• Set up scheduling optimization
• Create attendance dashboards
• Build workforce analytics
• Integrate with payroll systems