⚠️ If you’re already using Javelo and have users in the app, please read Preparing Javelo for External User Source Integration before proceeding.
How to configure the synchronization between Sympa and Javelo?
1- Create and get API credentials (client & secret) in Sympa
Select Settings > API (under integrations) in your Sympa account
Generate an API Key
Copy the Client and Secret keys for step 4
2- Set up a new integration in Sympa
In Sympa as an admin select Settings > API (under Integrations)
Click on the + sign to add a new integration
Set a name for the API to Javelo_user
Select GET as interface type
Select the key from step 1
Select the card base you want to sync
Select Active to be included
Make sure to paste the following text into Forced Filter ⇒ not(emailAddress eq null) and not(firstName eq null) and not(lastName eq null)
Select the unique identifier field
3- Define aliases for the fields you want to sync
On the API interface, add fields from your Sympa setup and link them with an Alias from Javelo you can find in the table below.
Here is an example of a standard Javelo/Sympa integration setup:
💡 Be extra careful and make sure there is no typo in the aliases and the mandatory aliases are setup. Otherwise, the synchronization will not work as expected.
Aliases for Javelo sync
Here are the aliases you can use for the synchronization Javelo:
Javelo Field name (Alias) | Mandatory | Description |
employeeId | YES | User ID from Sympa will not be displayed |
firstName | YES | The employee’s prefered first name |
lastName | YES | The employee’s last name |
emailAddress | YES | The employee’s email address |
jobTitle | NO | The employee’s job title |
lineManager | NO | The email address of the employee’s manager |
mobilePhone | NO | The employee’s phone number |
locale | NO | The employee’s prefered language |
firstDay | NO | The employee’s first hired day |
currentHiredOn | NO | The employee’s current hired day |
team | NO | The employee’s department, team,… |
lastDay | NO | The employee’s last date (this option will discard the user if the date is in past) |
4- Set up the integration in Javelo
⚠️ You need to have the company manager’s right to get to this part.
Go to “Settings" (⚙️ icon) in the upper right corner of your Javelo account
Select “Integrations” from the navigation menu under the Company section
Click on "Connect" in Sympa integration panel
Enter your Sympa Client and Secret keys from step 1
Click Apply and you are done 🎉
💡 The users will be synchronized automatically every morning.
How to deactivate the synchronization?
If you need to interrupt the synchronization, you can come back to the Integrations tab and click on “Disconnect” at the bottom of Sympa integration panel:
Then check the box "OK, I understand" and click "Confirm" to delete the integration :
What is synchronized with Sympa?
Javelo is synchronising Sympa users with the following attributes:
Last name |
First name |
Language |
First hired on |
Current hired on |
Department |
Phone number |
Job |
Manager |