Executive Summary

PyjamaHR’s calendar integration lets you seamlessly schedule interviews, sync events, and manage recruiting workflows directly from your ATS. If you need to switch calendar accounts, resolve integration errors, or update permissions, revoking or re‑authorising your calendar integration is essential. This guide walks you through the exact steps, common pitfalls, and best practices to ensure your calendar stays connected and your recruiting process runs smoothly.

Detailed Overview

What Is Calendar Integration in PyjamaHR?

Calendar integration in PyjamaHR connects your Outlook or Google Calendar with your ATS account, enabling automatic interview scheduling, event syncing, and streamlined communication with candidates. This integration is critical for recruiters who rely on up-to-date scheduling and want to avoid double-bookings or missed interviews.

When and Why Should You Revoke or Re‑Authorise?

You may need to revoke or re‑authorise your calendar integration if:

You’re switching to a different email/calendar account (e.g., from [email protected] to [email protected])
You receive persistent "Integration Failed" errors when connecting your calendar
You need to update permissions or resolve authentication issues
You want to disconnect a calendar that is no longer in use

Business Impact:
Keeping your calendar integration up-to-date ensures uninterrupted scheduling, prevents missed interviews, and maintains a professional candidate experience.

Step-by-Step Guide: Revoking or Re‑Authorising Calendar Integration

Prerequisites

Access to your PyjamaHR account with admin or integration permissions
Credentials for the Outlook or Google account you wish to connect
(Optional) Access to your organization’s IT admin if you face permission issues

A. Revoking (Disconnecting) Your Current Calendar Integration

Log in to PyjamaHR.
Navigate to the Integrations Section:
- Click your profile icon (top right).
- Select Settings > Integrations.
- (Screenshot: Show the Integrations tab with connected calendars)
Locate Your Connected Calendar:
- Find the section labeled Calendar Integrations.
- Your currently connected calendar (e.g., Outlook or Google) will be listed.
Disconnect the Calendar:
- Click the Disconnect or Remove button next to your calendar account.
- Confirm the disconnection when prompted.
- (Screenshot: Highlight the Disconnect button and confirmation dialog)
Wait for Confirmation:
- You should see a message confirming the calendar has been disconnected.

B. Re‑Authorising (Reconnecting) Your Calendar

From the Integrations Section:
- Click Connect Calendar or Add Calendar.
Select Your Calendar Provider:
- Choose Outlook or Google as appropriate.
Sign in With the Desired Account:
- Enter the credentials for the email/calendar you wish to connect (e.g., [email protected]).
- (Screenshot: Show the login prompt for Outlook/Google)
Grant Required Permissions:
- Accept all requested permissions to allow PyjamaHR to access your calendar.
- (Screenshot: Permissions consent screen)
Verify Integration:
- Once connected, your new calendar should appear in the Integrations list.
- (Screenshot: Show successful connection status)

C. If You Encounter "Integration Failed" Errors

Double-check you have fully disconnected the previous calendar.
Ensure you are using the correct email address and credentials.
Try using the same email currently displayed for integration, or switch to a different one as suggested by support.
If you are unable to disconnect the calendar yourself (button is disabled or missing), contact PyjamaHR Support with a screen recording for escalation.

Advanced Usage & Best Practices

Always disconnect old calendars before connecting a new one.
Attempting to connect a new calendar without revoking the previous one often leads to "Integration Failed" errors.
Use a dedicated recruiting calendar/email for integrations.
This avoids conflicts and ensures all recruiting events are centralized.
Keep your browser and PyjamaHR app updated.
Outdated versions may cause integration issues.
If you manage multiple brands or teams, ensure each has its own calendar integration.
Document which email is used for calendar integration in your team’s onboarding materials.

Do’s:
- Do use the same email for both email and calendar integration when possible.
- Do confirm permissions are granted during the authorisation process.

Don’ts:
- Don’t attempt to connect multiple calendars to the same PyjamaHR account simultaneously.
- Don’t ignore persistent "Integration Failed" errors—address them promptly to avoid scheduling disruptions.

Troubleshooting & Common Issues

Common Error: "Integration Failed"

Possible Causes:
- Previous calendar not fully disconnected
- Attempting to connect with a different email without revoking the old one
- Permission issues with Outlook/Google account

Solutions:
- Disconnect the current calendar in the Integrations section before reconnecting
- Use the same email as previously integrated, or fully remove and add the new one
- If unable to disconnect, provide a screen recording to support for manual intervention

What If I Can’t Disconnect My Calendar?

Sometimes the disconnect button may be disabled or missing.
In this case, record your screen showing the issue and send it to PyjamaHR Support for escalation.

What If I Need to Switch to a Different Email?

Disconnect the current calendar integration first.
Then, connect using the new email address.

Recovery Procedures

If you lose access to your calendar integration, repeat the revoke and re‑authorise process.
For persistent issues, escalate to support with detailed screenshots or recordings.

Comprehensive FAQ

1. Why am I seeing "Integration Failed" when connecting my calendar?
This usually means the previous calendar wasn’t fully disconnected, or you’re trying to connect with a different email. Disconnect the old calendar first, then reconnect.

2. Can I connect multiple calendars to my PyjamaHR account?
No, only one calendar integration is supported per account at a time.

3. What should I do if the disconnect button is missing or disabled?
Record your screen and contact PyjamaHR Support for manual disconnection.

4. Do I need to use the same email for both email and calendar integration?
It’s recommended for best results, but you can switch if you fully disconnect the previous integration.

5. Will disconnecting my calendar affect my scheduled interviews?
Existing events remain, but new events won’t sync until you reconnect a calendar.

6. How do I know which calendar is currently connected?
Check the Integrations section in your PyjamaHR account.

7. What permissions does PyjamaHR need for calendar integration?
Access to view and manage your calendar events.

8. Can I re‑authorise the same calendar if permissions change?
Yes, disconnect and reconnect to update permissions.

9. What if my organization uses SSO or admin restrictions?
Contact your IT admin to ensure permissions are granted.

10. How often should I review my calendar integration?
Review whenever you change roles, emails, or experience integration issues.

Email Integration: Ensure your recruiting email is also connected for seamless communication.
Interview Scheduling: Use the calendar integration to automate interview invites and reminders.
Team Collaboration: Assign calendar integrations per team or brand for better organization.

Still need help?
If you’re unable to revoke or re‑authorise your calendar integration after following these steps, contact PyjamaHR Support with a detailed description and screen recording of your issue for priority assistance.

How to Revoke or Re‑Authorise Your Calendar Integration in PyjamaHR (Outlook & Google Calendar)