Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: Adds personio_v2 provider #3089

Merged
merged 6 commits into from
Dec 2, 2024
Merged

feat: Adds personio_v2 provider #3089

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
d73d566
Adds personio v2 provider
tonibardina Nov 30, 2024
fe2181f
Updates docs links
tonibardina Nov 30, 2024
b108f07
Adds SVG symlink
tonibardina Dec 2, 2024
3e98715
Adds v1 specifications where needed
tonibardina Dec 2, 2024
d4729c7
Merge branch 'master' into feat/personio-v2-integration
bodinsamuel Dec 2, 2024
72da7f6
fix symlink
bodinsamuel Dec 2, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs-v2/integrations/all/personio.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,10 +29,10 @@ API configurations: [`personio`](https://nango.dev/providers.yaml), [`personio-r

- Personio offers a separate recruiting API that is API key based and is listed under `personio-recruiting`
- The other API Personio offers is a client credentials token that authorizes as app instead of a user. This is listed under `personio`.
- The `companyId` value is required for `personio-recruiting` and can be retrieved at Settings > Integrations (API Credentials) and clicking on the "Recruiting API Key".
- (Api V1): The `companyId` value is required for `personio-recruiting` and can be retrieved at Settings > Integrations (API Credentials) and clicking on the "Recruiting API Key".
The value for `company` as required for `personio-recruiting` is the name you use to login to your account
and is the subdomain of your Personio instance.
- The values for `partnerId` and `appId` are optional but strongly recommended by Personio. Both can be defined by you, but should represent your company name and application name and MUST follow the UPPER_SNAKE_CASE format. For example `MY_APPLICATION`, `ACME` are valid values.
- (Api V1): The values for `partnerId` and `appId` are optional but strongly recommended by Personio. Both can be defined by you, but should represent your company name and application name and MUST follow the UPPER_SNAKE_CASE format. For example `MY_APPLICATION`, `ACME` are valid values.
An example of setting them in the `nango.auth` call:
```ts
nango.auth('personio-recruiting', 'test-connection-id', { params: { companyId: '33434', partnerId: 'YOUR_CUSTOM_NAME', appId: 'UNIQUE_ID', company: 'company-b' },
Expand Down
15 changes: 15 additions & 0 deletions packages/shared/providers.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4632,6 +4632,21 @@ personio:
title: App ID
description: The app ID of your Personio account

personio-v2:
display_name: Personio (v2)
categories:
- hr
auth_mode: OAUTH2_CC
proxy:
base_url: https://api.personio.de/v2
headers:
Content-Type: application/x-www-form-urlencoded
token_url: https://api.personio.de/v2/auth/token
bodinsamuel marked this conversation as resolved.
Show resolved Hide resolved
scope_separator: ' '
docs: https://docs.nango.dev/integrations/all/personio
token_params:
grant_type: client_credentials

personio-recruiting:
display_name: Personio Recruiting
categories:
Expand Down
1 change: 1 addition & 0 deletions packages/webapp/public/images/template-logos/personio-v2.svg
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
personio.svg
Loading