Intergrations overview

In awork it's very easy to keep track of all your integrations with our tool. Just browse to "Settings" and "Integrations". On this page you can create and test your integrations.

Right now awork offers the following integrations:

You will find a list of all your integrations in this section. You can edit, pause or delete them via the action button. There is also the possibility to access the log of an integration. The log shows the actions from the last 20 days. Every successful integration will be marked green und the unsuccessful ones red (showing the reason for the error).


Billing Integration

You can create invoices directly from awork with the billing integration. The integration works with the following tools:

Set up integration 

Set up the integration in awork

To set up the billing integration go to settings / integrations. Now you can select your billing tool.

Then you need to enter the API key from your billing tool. (See below how to get the API key from your billing tool.) Just copy and paste the key into the field and click on save. Now the integration is activated. 


Get API key from the billing tool


You can find the API token under settings / user. 



Since 12.07.2020 Lexoffice is being integrated via oAuth 2.0 authentication. If you start an integration to Lexoffice from awork, you will be forwarded to Lexoffice and have to log in with your Lexoffice credentials. You are then redirected back to awork and can use the integration directly. The exchange of API keys is no longer necessary.

The integration is valid until the user (who authorized the Lexoffice integration) removes or blocks the authorization of awork in Lexoffice.


You can find the API token under Admin / API Clients


Create invoice

You can create invoices from time reports. Just click the dollar icon in the top and select create invoice.

Now you will be shown an overview of all your billable, not-billable and billed times.


Using new invoice vs existing draft

In this step, you can decide if you want to create a new invoice or use an existing draft. 


Select level for positions

Now you can select the following options for your invoice positions:

  • Groups = Positions: only the group titles with the sums of the groups will be used as invoice positions (this option is only available if you have grouped the time report!)
  • Sums = Positions: only the summed time entries will be used as invoice positions (this option is only available if you have activated sums in the time report!)
  • Times = Position: every time entry will be an invoice position. 


Position text and quantity unit

The next step allows you to select which entity should be used as text for the position. There are the following options:

  • Project name
  • Task name
  • User name

Furthermore, you can decide if you want to bill the times by days or hours. One day will always be eight hours.


Adjust data and enter prices

Now you can enter a price for each position. You can also add or edit data. There are the following options:

  • Change the name of the position
  • Change the number of hours/days
  • Delete positions
  • Change the order of positions
  • Create new positions


Mark time entries as billed and create invoice

The last step allows you to set all the time entries as billed and create the invoice in your billing tool. You can now close the window or go directly to the invoice in your billing tool.


Configure Calendar integration

The calendar integration in the "My Time Tracking" section enables you to see all your appointments from you usual calendar tools while working in awork. To activate it, go to "My Time Tracking" and click the button shown on the right.


When adding a new calendar you can select between three providers for your calendar

  • Google
  • Microsoft (Outlook & Exchange)
  • iCloud

When connecting a Google or Microsoft calendar, you will be guided to a new page where you can enter your normal login-data. After enabling awork to access your account, you will be redirected to awork. If you have multiple calendars in your account, you can choose to either integrate all of them or only a selection. Afterwards you can instantly view your appointments in your time tracking grid.

If you are using an iCloud-calendar, you will have to enter your Apple-ID in awork. Then go to and follow the instructions in the awork window: Navigate to Security and generate a new app-password. Enter said password in awork after confirming you have followed the steps and you can connect your iCloud-calendar.

As an alternative way to integrate a new calendar in awork, or even to manage existing calendars, you can use the calendar-button on the top right.


Now you will see the appointments from all the integrated calendars. The symbol of each appointment tells you, which calendar/provider the entry is from. You can create a time tracking for those appointments by simply clicking on them. The duration of the trackings will automatically equal the duration of the appointment.


Tipp: awork does not support self-hosted exchange servers.

Configure Microsoft Teams Integration

Configure Teams integration

To configure the Teams integration go to the channel you want to connect to awork, go to options and select Connectors. Now you can search for the awork app. Click on configure, log in to your workspace and select the project you want to connect to that channel. 

Now there will be a list where you can select which activities from awork should be posted to your Teams-channel.


Create a tab for awork

To create a new tab in a team-channel just click on the +button in your tab bar. A pop-up will appear, here you can search and select awork. Now you simply log in to your awork workspace and select the project you want to link to the tab. When opening the tab awork will ask you a second time to log in and you are good to go. 


Edit tasks in Teams

When a new task is created in awork it will be posted to the linked Teams-channel.


Now you can interact with that task in Teams. You can do the following things:

  • Change task status
  • (Re-)assign a user
  • Set a deadline
  • Comment on the task


Create tasks/time tracking entries from Teams

The awork Teams integration allows you to work in awork directly from Teams. You can use the following @-commands (The content between [ ] is the name of awork entities you want to use or create):

  • /add [task] - Creates a new task in awork
  • /comment [task]:[Text] - Creates a new comment on a task
  • /start [task/project] - Start time tracking for a task/project
  • /stop - Stop time tracking
  • /help- Shows you all available commands

E.g. you can simply type "@awork add Design new logo" in Teams. This will create the task "Design new logo" in your linked awork project.

Configure Slack integration

You can connect awork and Slack, so that your activities from awork will be postet to Slack. Furthermore, you can work on awork projects from within slack, e.g. create new tasks, edit existing tasks and much more.

Set up Slack Integration

To create the integration go to Settings/Integrations and click on the slack logo.

Now you will be forwarded to Slack and will be asked to enter your team name and allow awork access to your Slack-Team. Afterward, you will be forwarded to awork and need to log in to the workspace that should be linked to slack. 


Now every user that wants to actively use the integration needs to link his/her awork and Slack accounts. Users that just want to see messages in a channel don't need to do this. Every user will be asked to link the account when they have their first interaction with the integration. Alternatively, you can use the command "/connect" to link your accounts.

Tip: The language of messages from the integration is the one the user that created the integration has set in awork. Private notifications will be in the current users' awork language. 


Link an awork project with Slack

A project can be linked to a Slack channel from the project details. Just click the three dots and select Link to Slack. Now awork asks you to select the channel and all actions that should trigger a message in Slack.

The linked channel will be shown in the projects details. 

You can just link one project per Slack channel.


Linking closed Slack channels

Closed Slack channels can only be linked from within the Slack channel itself. 

First, the Slack integration must be set up in awork (see above).  

  1. Open the closed channel in Slack that you want to link.
  2. Invite the awork bot to the channel by posting a message with the text "@awork" in the channel.
  3. A window will open with a request to add awork to the channel. Confirm the invitation.
  4. For the slash command "/link". A project selection opens. Select the project to be linked to the channel.
  5. The project is now linked to the closed channel.
  6. The notification settings can be made in the awork project as described above.

Edit tasks in Slack

When a new task is created in awork it will be posted to the linked Slack channel. Now you can work with that task in Slack. You can do the following things:

  • Change task status
  • (Re-)assign a user
  • Set a deadline
  • Comment on the task


Create tasks/time tracking entries from Slack

The awork Slack integration allows you to work in awork directly from slack. You can use the following "/" commands (The content between [ ] is the name of awork entities you want to use or create):

  • /add [task] - Creates a new task in awork
  • /comment [task]:[Text] - Creates a new comment on a task
  • /connect - Link Slack account with awork account
  • /disconnect - Delete link between Slack und awork account
  • /link [project] - Link an awork project to a Slack channel
  • /start [task/project] - Start time tracking for a task/project
  • /stop - Stop time tracking
  • /unlink - Delete link between awork project and Slack channel

E.g. you can simply type "/add Design new logo" in Slack. This will create the task "Design new logo" in your linked awork project.


awork BOT/Show awork notifications in Slack

If you have linked your Slack account to your awork account you will find awork as an app in slack. In this "channel" you will see all your notifications if you choose to show them in slack.

You can also use all "/" commands. E.g. you can create private tasks or start a timer. 


Configure Zapier integration

About the integration

Zapier is a great tool to connect awork with a lot different tools, even without deep programming knowledge. 

Zapier works in two directions: You can get information out of awork and post it into another tool or you can take information of a tool and create an entity within awork We offer the following options

Get information out of awork (Trigger)

  • New task created
  • New time tracked
  • Tracked time updated

Create awork entities (Action)

  • Create a new project
  • Create a new project-task
  • Create a new client

How to set it up


To create your first Zap (yes, it's called that way) navigate to "Settings" / "Integrations" and click of the Zapier button (or choose to add a predefined snap by us). 


You will be forwarded to the Zapier homepage. Here you can choose the app that you want to connect with awork (e.g. Slack).


Now you have the option to choose a commonly used connection or select a trigger and action in either app. 


Zapier will show you a short summary of your selections.


Zapier will lead you through some steps where you need to confirm the selected settings. Our example should create a awork task when a slack message gets starred. 

So after a few screens you need to select which slack field will be the name of the awork task (1), select the awork project (2), Type of Work (3) and Task Stastus (4). 

ATTENTION: The options you need to set depend on the app and trigger you selected.


Now Zapier will ask you to run a test zap (the data of this test will show up in your awork workspace). Afterwards you are done, save you zap and set the connection to active. 

Zapier Integration with Webhooks

If you want to get information from awork that is not in our standard zapier integration, you can use webhooks.

Go to and select "Webhooks" as a trigger.



Select the option "Catch Hook".


Copy the url on the next screen into an awork webhook. More information about how to do that here.


Now you need to add a filter where you can decide details on the information that should trigger the zap, e.g. the task status. Now just continue as described above. 


Configure Shift-Integration

Shift ist a tools that helps you to integrate all of your apps into one tool and helps you to be more productive. Now you can also add awork to your shift account

Configure Shift integration

Go to Shift and click on the + Button to add a new application. Search for awork and click on the awork icon. Now you can select a name and a color for the awork integration. Afterwards all you have to do is log into your awork account and your are ready to go. 


Set up Single Sign-On (SSO)

To make awork even more secure for enterprise users, awork now supports single sign-on (SSO) using the OpenID Connect standard with many preconfigured identity providers. If SSO is configured for awork, the login to awork can take place via an existing identity management with existing employee accounts and there is no need to create a separate awork account with an insecure password.

The list of our supported identity providers include: OneLogin, Okta, Auth0, Azure AD and GSuite. If you cannot find the identity provider you use at your company, please contact us directly.

Note: SSO is only available in the awork Enterprise plan. ☝️  SAML 2.0 is currently not supported, because we decided for the more modern and easier to configure OpenID Connect standard.


Supported identity providers


  1. Go to the main menu under Settings and select the menu item Integrations.
  2. Click on Start setup in the Single Sign-On block.
  3. Select the desired provider.
  4. The subdomain, client id and client secret of the provider must now be entered in the window. Instructions on how to set up awork as an SSO application with the respective provider can be found below. When setting up awork, you will receive the subdomain, client ID and client secret, which must be entered here.

Important notes on the setup

The following urls need to be allowed:{name of the login provider}
(like okta, auth0, onelogin, azure, gsuite)

For the login via the web interface at you need:

For the authorisation of slack you need:

For the authorisation of Microsoft Teams you need:

For zapier integrations you need:


  1. Open the Okta configuration under
  2. Go to the menu in the Applications section.
  3. Add a new application and name it e.g. awork.
  4. In the details of the application you get client id, client secret, subdomain. Enter these in the awork configuration window and save.

Note: It is important to the the Login redirect URIs correct, so that your Okta users are redirected correctly. You also need to activate the der Implicit(Hybrid) Flow including ID Token grant type. The User consent is not needed because awork only accesses the name and e-mail address of the Okta user.


  1. In the Login section of the Okta application, set the following URIs
    1. Initiate login URI:
    2. Login redirect URIs


  1. Open the Auth0 configuration at
  2. Go to the Applications section in the menu.
  3. Add a new application and name it e.g. awork.
  4. In the details of the application you will get client id, client secret, Subdomain. Enter these in the awork configuration window and save.
  5. The application in Auth0 must be of the type Regular web application.
  6. Set the following URIs in the Login section of the Auth0 configuration
    1. Application login url:
    2. Allowed callback URIs
    3. Allowed web origins:


  1. Open the OneLogin configuration under
  2. Go to the Applications section in the menu.
  3. Add a new app.
  4. Select OpenID Connect (OIDC) as type and set the name to e.g. awork and save.
  5. In the details of the app you get Client-ID, Client-Secret, Subdomain. Enter these in the awork configuration window and save.
  6. Set the Application type web in OneLogin and set the following URIs:
    1. Login url:
    2. Redirect URIs


  1. Open the Azure AD configuration at
  2. Go to the Azure Services section and then Azure Active Directory.
  3. Click on App Registrations in the menu.
  4. Add a new registry and name it awork, for example.
  5. Set the redirection URI to web and
  6. In the details of the new registry you will get the client ID. Enter this in the awork configuration window.
  7. In the Certificates & Secrets section of the Azure configuration, you must now generate a new client secret. Enter the client secret in the awork window as well.
  8. In the Authentication section, check the box ID tokens in the Azure configuration and enter the following URIs
    1. Redirect URIs
  9. The subdomain field in the awork window can be either:
    1. your tenant ID: Active Directory-How to find tenant
    2. your azure url: <customer>


To set up SSO with GSuite you need to follow the following steps:

  1. Go to and select the project you want to set up SSO for
  2. Click on "Create Credentials" and select "OAuth client ID"
  3. Select "Web application" as the application type
  4. Choose a name like "awork"
  5. In the area "Authorized redirect URIs" you need to add the following urls:
  6. After that you save with a click on "Create"
  7. On the following page you can find the Client ID and the Client secret that you need to enter in awork



You can find more infos about the setup under

After the setup

If the configuration was successful, the SSO sign-in is now available in the login area of your workspace.

Note: Rights, users or groups are currently not controlled via the external identity provider, so you still need to configure user groups and rights in awork itself.

Deactivate other login options

After SSO was set up successfully, you can deactivate other login options such as login via e-mail and password or via google or apple login (social login) for the whole workspace.

This is only recommended, if there are no external users in your workspace that do not have an external account in your identity provider.

Note: If you remove the SSO provider, login via e-mail and password is activated automatically in order for you to be able to login with your admin account.

Infos for login with SSO via

To login with SSO via the global login page, you can select the option Sign in with SSO. First you need to enter the subdomain of your workspace and then your are redirected to the login page of your provider, or if you are already logged in, directly redirected to your dashboard.

The other login options (login with e-mail and password and social login) are still visible on the global login page. However, they cannot be used to login to your workspace if you deactivated those options.

Google Assistant (awork Voice)

awork voice  is the skill from awork for the Google Assistant. With awork voice you can use awork via voice commands.

To do that you need to activate the awork voice skill in your Google Assistant account. 

Afterwards you can use the skill in Google Assistant and on the Google Home devices. 

What can I do with awork voice?

Even though awork voice is still in it's infancy, you can perform many helpful actions:

Create new task

"Ok Google, talk to awork voice. Create a new task: Prepare presentation"

Now you will have a new private tasks "Prepare presentation". At the moment awork voice only supports private task, because there are still some challenges to match task to projects via voice. 

After you create a task, awork voice will ask you to set a deadline. You can simply answer something like "tomorrow", "Monday" or "Next week".

Start and stop time trackings
"Ok Google, talk to awork voice. Start a timer."

"Ok Google, talk to awork voice. Stop the timer."

awork voice will ask you if you want to work on the same task, if your last time tracking was connected to as task. 

If there is already a timer running, awork voice will ask if you want to stop the timer to start a new one or if your comment should be ignored. 

Recommend a task

"Ok Google, talk to awork voice. Is there anything to do?"

 awork voice will recommend your most urgent task to you. If you want to work on another task just say "next" or "Give me another task". 

If you say "Start timer" you start tracking time for that task.

Ask for due tasks

"Ok Google, talk to awork voice. Are there any due tasks till Monday?"

awork voice will tell you the amount of tasks you have to finish till Monday.

 Check for new notifications

"Ok Google, talk to awork voice. Are there any new notifications?"

awork voice will tell you if you have any new notifications.

Set up awork voice

The setup of awork voice does not work with a google home device, because you will need a display and a keyboard to sign in. If you connected it with your google account, you will be able to use your google home devices. 

1. Download the Google Assistant app

  • Google Assistant comes preinstalled on most Android smartphones. Otherwise you can download it in the Google Play Store.
  • If you use an iPhone download the app from the App Store.
  • Sign in to the app with your Google account

Unfortunately you can't use the Google Assistant in a web browser. 

2. Activate awork voice

  • Open the following link on your smartphone: awork - Google Assistant 
  • You smartphone should forward you to the google assistant app and show the details for awork voice. Click on "try now" to acticate awork voice.
  • If you are singed in to your Google account you can now send awork voice to your connceted devices via your browser (link).


3. Connect your awork account with google

To tell awork voice which user and workspace to use, you need to connect awork and awork voice. awork voice will prompt you to login to awork. Your information will be saved in your Google account. 

  • Google Assistant App: Start awork voice by saying / writing "Ok Google. Talk to awork voice" Now the app will ask you to log in to awork.
  • You can connect to awork in your web browser using this Link and click on connect. Now you will see the awork log in screen. You can only see the button if you are signed in to Google. 

4. Active the Assistant

You can activate the assistant with the command "Ok Google, talk to awork voice". Now awork waits for your commands.

awork voice is closed right after every conversation. This means you need to repeat the command for every interaction.


  • The Google Assistant will handle awork voice commands as private and limit themn though Voice Match, because awork voice demands a login to awork. Only the User of the Google Account kan use the functions of awork voice via voice commands.

Configure Shift integration

Currently there is no native integration with Shift

The Shift Support provided us with the following workaround to integration awork into Shift.

  1. Go to the Apps Menu
  2. Search for the awork app and click on the + button to add it to your apps menu
  3. Click on the "Use Custom URL" checkbox 
  4. Add the URL for your awork workspace. Be sure to include the entire URL
  5. Name your app and choose a color, then SAVE

awork will appear in your sidebar with the awork logo and the color and naming of your choice. 

For further questions please contact the Shift Support (

Configure integration

The basis for the integration between awork and is Zapier. The process is the one for our normal Zapier integration.

First you choose (1) and connect it with awork (2). The trigger needs to be "New Manual Trigger" (3) and the action "Create Project" (4).


Now you need to connect your Zapoer and account.


To do so you need to create an API key for :


Now you can enter the key on the next screen.


Now just proceed with the normal steps from our Zapier integration

Client Applications and API Keys

The awork web app is a single page application (SPA) that communicates with the awork server cluster via the awork API. This API is public and therefore accessible for building your own apps, integrations or for connecting business intelligence tools (BI / Analytics).

(Of course, public still means that a corresponding authentication must be carried out).

API key with user rights

If the users themselves should be able to log in to the own developed app/integration with their awork account, a new client application must be created in awork for this purpose. 

The user login is important for apps and applications where the user's permission management should take effect (this is done via oAuth 2.0 - more on this in the Developer Resources).

API key without user reference with admin rights

If this does not matter, an API key without user reference can also be generated with admin permissions, e.g. for analytics, interfaces, etc. Here you can find out how to get the key.  


Clients for your own apps with user login

If you want to build your own app for awork, where the users should log in themselves, you must create a client application in awork. In the main menu, go to Settings and then to Integrations. There you will find the Client Applications section. 

  1. Click on + to create a new client application.
  2. Create a name and a client id (this id must be unique).
  3. Add a redirect URL (see Developer Resources for more details).
  4. Save the client application.
  5. After saving, you will receive the client secret. Copy this and keep it safe.
  6. With the client id and the client secret you can now build your own oAuth 2.0 login where users can authenticate themselves with their awork account. 

Check out our Developer Resources to learn more about oAuth 2.0 login.



API Key without User Authentication

If you want to build an integration for awork or simply need an API key to request data, you must create a client application and generate an API key.

In the main menu, go to Settings and then to Integrations. There you will find the Client Applications section. 

  1. Click on + to create a new client application.
  2. Set a name and a client id (this id must be unique).
  3. The redirect URL is not relevant in this case, as only the API key is needed.
  4. Save the client application.
  5. Close the window with the client secret.
  6. Your new application now appears in the list of client applications.
  7. Click on the more button (3 dots) and select Manage API Key.
  8. Add a new API key via the + button.
  9. You can now copy the API key using the small key icon on the right-hand side.
  10. Copy the API key to the clipboard and keep it safe. You can now use it for your integration or data query.

Check out our Developer Resources to learn how to continue working with the API key.




To create a webhook go to "Settings" / "Integrations". Click on the webhooks button.


Now you can select a name (1), enter the URL (2) and select if an authentication is needed. You need to select an event that triggers the webhook (4) and test it (5). Not you can save it.


You can see a list your webhooks on the integration page (7). You can edit (7), pause (8), delete (10) your webhooks or check it's logs (9).



The following events in awork can trigger webhooks:

  • Client added
  • Client deleted
  • File added
  • File deleted
  • Project added
  • Project comment added
  • Project deleted
  • Project member added
  • Project member deleted
  • Project status changed
  • Project task added
  • Project task deleted
  • Task assignment added
  • Task assignment deleted
  • Task comment added
  • Task status changed
  • Time tracking added
  • Time tracking deleted
  • User activation changed
  • User added
  • User deleted
  • User status changed