HR system integration - AFAS update before 1 May 2027

This article explains how to update the AFAS integration that connects your employee data to My Effectory. The integration currently uses a Classic token from your AFAS environment. AFAS is retiring this authentication method, so the connection must switch to OAuth client credentials. My Effectory supports this method.

If someone in your organization manages AFAS, involve them in these steps.

Why this change is needed

• AFAS stops accepting Classic tokens on 1 May 2027. After that date, all connections must use OAuth.
• Once the Classic token stops working, the integration stops and employee data no longer syncs to My Effectory.

Before you begin

• Make sure you have access to AFAS (App Connector and Get Connector management) and to My Effectory (Integrations settings).
• Plan the update well before 1 May 2027.

In AFAS

Step 1: Export your field template

Go to Manage GetConnector in AFAS. Export your existing Get Connector. This saves you from selecting the fields again when you set up the new App Connector.

Step 2: Create a new App Connector

Go to Algemeen → Beheer → App Connector. Create a new connector.

Step 3: Select the authentication type

Choose OAuth client credentials.

Step 4: Re-use the existing groups and users

Use the groups and users that were created for the initial Effectory integration. Do not create new groups or users.

Step 5: Import your Get Connector

Click Actions. Import the file you exported in Step 1.

Step 6: Review the imported connector

Double-click the imported Get Connector and click Next. Check that the data fields match your existing connector, including any filters you have set up.

Step 7: Save the connector and store the credentials

Save the connector. The new credentials are shown on screen. Copy the client ID and client secret and store them securely.

In My Effectory

Step 1: Enter the new credentials

In My Effectory, go to Integrations → Settings. Paste the client ID and client secret from AFAS.

Step 2: Sync your data

Go to Integrations → Data runs. Click Sync now.

Step 3: Check your data

When the sync finishes, confirm that your data is correct and matches your connector template. If anything looks different or is missing, check your connector template in AFAS or contact support.

Step 4: Remove the old App Connector

Once your data checks out, remove the old App Connector in AFAS.

Your connection is now updated and running on OAuth client credentials.