Skip to main content

Workvivo: Connect the marketplace app

How to create an API key in Workvivo and connect the app to Journeys

Written by Helga Björg Helgadóttir

By connecting the Workvivo app, you will be able to update profile pictures, add employees to teams and spaces, post announcements, create events, and send notifications, all via Journeys 🚀

🧠 Note: If you plan on creating or deactivating Workvivo accounts, that is handled by the separate Workvivo SCIM app.

Many organisations will not need it, however, as Workvivo accounts can be auto-created via Microsoft Entra, Okta, or an HR system.

Before you start

Two things need to be in place in Workvivo:

  1. API access enabled for your organisation

    Off by default. If you don't see API Keys & JWT Settings in your Workvivo admin panel, contact Workvivo Support to have it enabled. This can take a few days.

  2. The Developer role, granted to you

    Separate from Admin, and an account administrator has to grant it under Admin → Tools → People → Roles.

Step 1: Find your Workvivo ID and API URL

  1. In Workvivo, go to Admin → Tools → Platform → API Keys & JWT Settings.

  2. At the top of the page you'll see a banner with two values you'll need later:

    • Your Workvivo ID: a number, for example 1234567

    • Your API URL: for example https://api.eu2.workvivo.com

    Copy both. Your API URL depends on where your Workvivo account is hosted, so use the one shown on your screen.

Step 2: Create an API app

  1. On the same page, select Add New App.

  2. Give it a name, e.g. "50skills-Journeys", and tick the following permissions:

Section

Permissions

Events

events.*.read, events.*.write

Users

users.*.read, users.*.write

Teams

teams.*.read, teams.users.write

Spaces

spaces.*.read, spaces.*.write

Updates

updates.*.read

updates.*.write

Notifications

notifications.*.read

notifications.spaces.write, notifications.teams.write, notifications.users.write

Leave everything else unticked and click Save. You can change these later by clicking on Edit on the app.

Why these permissions? They cover exactly what the integration does: looking up employees, updating profile pictures, managing team and space membership, posting updates, creating events, and sending notifications.

Step 3: Generate an API key

  1. Find your new app in the list and select Manage Keys, then Add New Key.

  2. Name your API key something like "50skills-Journeys".

  3. Click Save and then copy the key immediately. Workvivo only shows it once and it can't be retrieved afterwards. If you lose it, you'll need to generate a new one.

Step 4: Connect in Journeys

  1. In Journeys, go to the app marketplace, find Workvivo, and select Connect.

  2. Paste:

    Workvivo ID: from the banner in step 1

    API URL: the API URL from the banner in step 1

    API key: the key you copied in step 3

  3. Then click Connect

If it succeeds, you're ready to use Workvivo actions in your journeys 🚀

Related Articles
Did this answer your question?