Skip to main content

Persona integration (API)

Use the Persona integration to sync employee clock-in and clock-out registrations from Begin directly to Persona.

Written by Gerda Lill

Note: Persona API integration must be enabled by the Begin team before it becomes available in your account.

Configure sync settings

Before setting up the integration:

  • Obtain the API username and password from your Persona administrator.

  • Ensure each employee has a Personal code configured in their employee profile. The personal code must match the employee identifier used in Persona.

To configure the integration:

  1. Go to Integrations.

  2. Open Persona.

  3. Turn on Enabled.

  4. Open the Setup tab.

  5. Enter the API username and password.

  6. Click Save Credentials.

The following fields are included automatically:

  • Personal code

  • Clock in

  • Clock out

Note: The sync format is predefined and cannot be modified.

Location filter

You can optionally limit the sync to specific locations.

  1. In the Location Filter section, select one or more locations.

  2. Click Save.

If no locations are selected, data from all locations will be synced.

Sync schedule

You can enable automatic syncing using the Sync Schedule section.

  1. Enable the schedule toggle.

  2. Select how often the sync should run.

  3. Save your changes.

You can also run syncs manually at any time from the Sync tab.

Run sync

  1. Open the Sync tab.

  2. Select the period you want to sync.

  3. Click Run Sync.

  4. Wait for the sync to complete.

Begin sends employee clock-in and clock-out registrations directly to Persona.

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 username and password are correct.

Employee not synced

Make sure the employee has a Personal code configured in their employee profile.

Registration missing from Persona

Verify that the registration falls within the selected sync period and matches the configured location filter.

Automatic sync has stopped

Repeated sync failures may pause the sync schedule. Resolve the underlying issue and re-enable the schedule.

Need help?

If the sync fails or Persona does not receive the expected data, contact our support team through the in-app chat or email support@begin.ee.

Did this answer your question?