It is now possible to create employees in Bara tala using Journeys.
Start by creating the integration in the Integration Builder, located in settings.
1. Authentication
You need to contact Bara tala to get the following information for authentication to your account:
company_id
company_secret
Once you have that, set up the authentication like this:
Authentication type: API key
Header key: x-api-key
API key: VIRe2NwdBqnD9e4WSNpZTTjKZwAm7wpM
Extra headers:
{
"x-company-id": "company_id",
"x-company-secret": "company_secret"
}where you put in your own company_id and company_secret from Bara tala
2. Endpoints
'Add user' endpoint
Create a new endpoint for adding a user/employee to your company in Bara tala
The URL is: https://adduser-3wqke2qrtq-ew.a.run.app
Example request is:
{
"email": "employee-email@company.org",
"silent": "false",
"department": "Allir",
"displayName": "Full name",
"phoneNumber": "+3541234567"
}
'Get user ID' endpoint
Create a new endpoint to get the ID (auðkenni) of a user, either via the user's email or phone number
The URL is: https://getuserid-3wqke2qrtq-ew.a.run.app
Example request is:
{
"email": "email",
"phoneNumber": "phoneNumber"
}When you test this endpoint, you either put in an email address or phone number to get an id.
The response will give you the user's uid, which is the ID you need to update or remove the user.
'Remove user' endpoint
Create a new endpoint for removing a user/employee from your company in Bara tala
Example request is:
{
"userId": "userId"
}The userId is the uid from the 'Get user ID' endpoint.
3. Using Bara tala endpoints in Journeys
'Add user' action
Add the 'Add user' action to your journey and map the fields for email, department, name and phone number:
'Get user ID' action
Add the 'Get user ID' action that gets the user ID from Bara tala, map either the email or phone number:
'Remove user' action
Add the 'Remove user' action to your journey.
For the field "Auðkenni notanda", select the uid (auðkenni) from the 'Get user ID' action above.
Now you should be ready to use the Bara tala integration! 🚀