Note: Horizon REST API must be enabled by the Begin team before it becomes available in your account.
Configure sync settings
Before setting up the integration:
Obtain the Horizon REST API URL.
Obtain a Horizon API username and password.
Ensure employees have a Personal code configured in Begin.
To configure the integration:
Go to Integrations.
Open Horizon (REST API).
Turn on Enabled.
Enter the API URL.
Enter the Horizon API username and password.
Save your changes.
Choose which syncs you want to enable:
Salary Export – sends worked hours and overtime to Horizon.
Daily Breakdown Export – sends detailed daily records to Horizon.
Absences Export – sends all-day absences to Horizon.
Employee Sync – updates employee information in Begin from Horizon.
For absence exports, map each Begin absence type to the corresponding Horizon absence code.
You can also configure automatic syncs using the Sync Schedule section.
Run sync
Open the Sync tab.
Select the period you want to sync.
Click Run Sync.
Wait for the sync to complete.
Sync history
Every sync is recorded in the sync history.
For each sync, you can view:
Sync status
Sync period
Number of records processed
User who started the sync
Any returned errors or warnings
Troubleshooting
Authentication failed
Verify that the API URL, username, and password are correct.
Salary entries use incorrect pay types
Verify the configured Horizon pay type settings.
Absence not synced
Only full-day absences can be exported to Horizon. Hour-based absences are skipped.
Employee not synced
Make sure the employee has a Personal code configured in Begin.
Need help?
If the sync fails or Horizon does not receive the expected data, contact our support team through the in-app chat or email support@begin.ee.