(Oct 10) Doc updates: Time-off, OAuth2, pagination

Announcements
,
1

:wave: Hi there, it’s been a while

:mega: I’m here to share some new doc updates with you:

:new: New

  • New guides on how to manage time off (Get policies + Entitlements + CRUD operations on time-off requests)

:up: Updated

:x: Removed

  • Removed old time-off guide for the EOR API because now everything is consolidated into the Time-off API

  • Removed all mentions of v1 from the Guides as a consequence of the v1 API deprecation

Hope you find them useful and always looking forward to receiving your feedback.

Cheers,

Stefano

3 Likes
2

Thanks for the OAuth guide !

I have a question about the usage of personal vs. organizational tokens for timesheet apps.
I have to integrate an app that stores the timesheets from contractors google calendar.

I’m new to the ecosystem, should I create a public app ? How to develop this kind of apps during development ?

3

Hello Christian and welcome to the community!

I understand that you have doubts about the usage of personal or organizational tokens for a timesheets app. However, I don’t understand what the specific question is.

If your doubt is about what token you should pick for your app, I recommend taking a look at Organization apps and personal apps. There we suggest to choose “organizational” tokens for this use case.

If your doubt is about whether the app should be public, I hope the following clarification can help you:

When you create an app, it’s automatically submitted for a security review to our team. Until the app is approved by our team, it can be used by users inside your organization without any limitation or for testing purposes. However, if you try to use it with users outside of your organization, that won’t work. After we approve it, the app will also work outside of your organization.

An app does not require to be published on the App Store to be used outside of your organization. You can publish it on the App Store if you want it to be showcased (the process is outlined in Request an app to be published on the App Store). However, that’s not mandatory for the app to be used by users outside of your organization.

Please let me know if this helps get some clarity.

1 Like