Follow this guide to set up a Microsoft Teams integration in Journeys.

‼️ Before you begin: Please contact 50skills support to obtain your integration_token. This is required to authenticate your company's connection.

Step 1: Register an App in Microsoft Entra

Log in to Microsoft Entra here: https://entra.microsoft.com
In the search bar, search for App registrations
Click New registration
Fill out the following fields:
1. Name: 50skills Journeys Integration
2. Supported account types: Accounts in this organizational directory only (50skills only - Single tenant)
3. Redirect URI: Web, http://localhost
Click Register
Copy the Client ID and Tenant ID, as shown in the screenshot below, and store in a safe place:

Step 2: Generate a client secret

In the left sidebar, go to Certificates & secrets and click "New client secret".
Fill in:
- Description: Journeys - Teams Integration - YYYY-MM-DD
- Expires: Your preferred expiration date
  - 🔒 Note: This is required by Microsoft to improve security.
  - ⏳ Tip: Set a reminder to create a new client secret before the current one expires
Click Add.
⚠️ Copy the client secret value immediately (you won't see it again)

Step 3: Add Microsoft Graph API Permissions

In the left sidebar, go to API permissions and click "Add a permission"
Select Microsoft Graph > Delegated permissions
Search for "OnlineMeetings" in the search bar and add:
- OnlineMeetings.ReadWrite
Next, search for "Calendars" and add:
- Calendars.ReadWrite
Click Add permissions

Step 4: Generate the Authorization Code

Paste the following URL into a browser:

https://login.microsoftonline.com/{TENANT_ID}/oauth2/v2.0/authorize?
client_id={CLIENT_ID}
&response_type=code
&redirect_uri=http%3A%2F%2Flocalhost
&response_mode=query
&scope=offline_access%20User.Read%20OnlineMeetings.ReadWrite%20Calendars.ReadWrite
&state=journeys

where you replace {TENANT_ID} with your tenant ID and {CLIENT_ID} with your client ID.

You will be prompted to log in with your Microsoft 365 account.
After consenting, you'll be redirected to:
```
http://localhost/?code=...&state=journeys
```
Copy the code value from the address bar. This is your authorization code.

Step 5: Get your refresh token

Open your terminal
If you're on:
1. Mac: Open the Terminal app.
2. Windows: Open Command Prompt or PowerShell.

Copy and edit the curl command below. Replace the 4 placeholder values ({TENANT_ID}, {CLIENT_ID}, {AUTHORIZATION_CODE}, and {CLIENT_SECRET}) with the values you got from previous steps.

curl -X POST https://login.microsoftonline.com/{TENANT_ID}/oauth2/v2.0/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "client_id={CLIENT_ID}" \
  -d "scope=offline_access https://graph.microsoft.com/.default" \
  -d "code={AUTHORIZATION_CODE}" \
  -d "redirect_uri=http://localhost" \
  -d "grant_type=authorization_code" \
  -d "client_secret={CLIENT_SECRET}"

Paste the command into the terminal and press Enter. You'll get a response like this:

{
  "token_type": "Bearer",
  "expires_in": 3600,
  "access_token": "eyJ0eXAiOiJKV1Qi...",
  "refresh_token": "0.AAA..."
}

Copy the value next to "refresh_token" (without the ""). It's a long string that looks like 0.AAA...zY_e3w. Store this refresh token securely.

Step 6: Configure Authentication in Journeys

Now you have completed the necessary steps in Microsoft Entra. Next step is to set up the authentication in Journeys, using the tenant ID, client ID, client secret, refresh token, and integration_token.

In Journeys' Integration Builder, open your Microsoft Teams integration, or ask our team to copy the template to your account if we have not done so already.
Go to Authentication and fill in the following fields:
- Authentication URL: https://journeys-token.50skills.workers.dev/
- Client ID: your client_id from Step 1.
- Client secret: your client_secret from Step 2.
- Extra data:
```
{
"scope": "offline_access https://graph.microsoft.com/.default",
"provider": "microsoft",
"integration_token": "{INTEGRATION_TOKEN}",
"tenant_id": "{TENANT_ID}",
"refresh_token": "{REFRESH_TOKEN}"
}
```
  where you replace {INTEGRATION_TOKEN}, {TENANT_ID}, and {REFRESH_TOKEN} with your own.
  - Note: if you don't have an integration token, please ask the 50skills team to generate one for you 🔑
Click on Test and make sure you get a successful response.

And you are done! 🎉 You can now start using the Microsoft Teams integration in your journeys 😄

Setting up SSO with Azure and Journeys

Kjarni integration in Journeys

Integration with Sharepoint

Bara tala integration in Journeys

Google Calendar integration in Journeys