# Personio integration

> HR software for mid-size companies: people, employments, attendance, absences, projects, documents, payroll compensations, org structure, reports, webhooks and recruiting.

- Authentication: apiKey

## Tools (77)

- **Add Project Members**: Adds a list of project members to a project.
- **Create an attendance period**: Create an attendance period and return newly created attendance period ID.
- **Create a new absence period**: Creates a new absence period.
- **Create a new Person and Employment**: - This endpoint enables the creation of a Person resource and an associated Employment resource.
- **Create a project**: Create a project and return the newly created project ID.
- **Create Compensation**: Requires credential with both `personio:compensations:read` and `personio:compensations:write` scopes.
- **Create Compensation Types**: Creates a new Compensation Type and returns the created resource with its UUID.
- **Create new webhook**: Create a new webhook.
- **Delete an absence period by ID**: Deletes an absence period by ID.
- **Delete an attendance period by ID**: Deletes an attendance period by ID.
- **Delete a Person**: - This endpoint enables the deletion of a Person resource.
- **Delete a Project**: Delete a project by given project ID.
- **Delete a webhook**: Delete a webhook.
- **Delete document**: Deletes the Document with the provided Document ID.
- **Download document file**: Downloads the file associated with the provided Document ID.
- **Get Absence Balance for Employee (v1)**: (v1, no v2 equivalent) Retrieve the absence balance for a specific employee
- **Get absence period by ID**: Retrieves an absence period by ID.
- **Get absence type by ID**: Retrieves an absence type by ID.
- **Get application by ID**: Retrieves an application for the provided application ID.
- **Get attendance period**: - Retrieves an attendance period by given attendance period ID.
- **Get candidate by ID**: Returns a candidate for the provided ID.
- **Get daily absence period breakdowns for a given absence period**: Retrieves daily absence period breakdowns for a given absence period.
- **Get Employee Profile Picture (v1)**: (v1, no v2 equivalent) Show employee's profile picture.
- **Get employment**: Retrieves an employment for the provided ID.
- **Get job by ID (Recruiting)**: Retrieves an job for the provided job ID.
- **Get job category by its ID (Recruiting)**: Retrieves a job category for the provided category ID.
- **Get Job (Jobs and Salary Bands)**: - Returns the requested Job.
- **Get legal entity**: Returns a legal entity for the provided ID.
- **Get Org Unit**: - Returns the requested Org Unit.
- **Get person**: This endpoint returns a specific person identified by the ID parameter.
- **Get Project**: Retrieves a project by given project ID.
- **Get report**: Retrieves a report for the provided ID.
- **Get Salary Band**: - Returns the requested Salary Band.
- **Get webhook**: Get a webhook.
- **Get webhook delivery activity**: Returns delivery activity for a specific webhook.
- **Get webhook events**: Returns events for a specific webhook.
- **List absence periods**: - This endpoint returns a list of absence periods.
- **List absence types**: List absence type.
- **List all applications**: Returns a list of applications for an authorized company, sorted by last updated date, newest first.
- **List all application stage transitions for an application ID**: Returns a list of application stage transitions, ordered by latest-first for the provided application ID.
- **List all candidates**: Returns a list of candidates for an authorized company, sorted by last updated date, newest first.
- **List all job categories (Recruiting)**: Returns a list of job categories for an authorized company.
- **List all jobs (Recruiting)**: Returns a list of jobs for an authorized company, sorted by last updated date, newest first.
- **List Allowed Employee Attributes (v1)**: (v1, no v2 equivalent) Lists all the allowed atrributes per API credentials including custom (dynamic) attributes.
- **List all report attributes for a company**: Returns a list of the reports company attributes.
- **List all reports for a company**: Returns a list of reports available for the company.
- **List all workplaces**: - Returns a list of existing workplaces for an authorized company.
- **List attendance periods**: List attendance periods by given filters.
- **List compensations**: Returns a list of payroll compensations of people for an authorized company.
- **List Compensation Types**: Returns a list of Compensation Types for an authorized company.
- **List cost centers**: - Returns a list of existing cost centers for an authorized company.
- **List Document Categories (v1)**: (v1, no v2 equivalent) This endpoint is responsible for fetching all document categories of the company.
- **List document metadata**: Lists the metadata of Documents belonging to the provided owner ID.
- **List employments of a given Person**: Returns a list of employments of a given person.
- **List jobs (Jobs and Salary Bands)**: - Returns a list of existing Jobs for an authorized company.
- **List legal entities**: - Returns a list of existing legal entities for an authorized company.
- **List Org Units**: Returns a paginated list of Org Units for the authenticated company.
- **List persons**: - This endpoint returns a list of persons.
- **List Project Members**: List all project members by given project ID.
- **List Projects**: List all projects by given filters.
- **List salary bands**: - Returns a list of existing Salary Bands for an authorized company.
- **List webhooks**: Returns a list of webhooks.
- **Redeliver events for a webhook**: Redelivers events selected by the request parameters.
- **Remove Project Members**: Remove project members from a project.
- **Rotate the webhook's signing secret**: Generates a new active signing secret (or accepts a customer-supplied `value`) and moves the previous active secret into a 7-day retiring grace window.
- **Send a ping event**: Use this endpoint to trigger a test event of type `ping` for a specific webhook.
- **Send a test event with custom payload**: Triggers a test event with a specific event type and custom payload data for a webhook.
- **Submit an application**: Submits a new application for a job position, on behalf of an authenticated OAuth client.
- **Update an absence period by ID**: Updates an absence period by ID.
- **Update an attendance period**: Update an attendance period by given attendance period ID and return the attendance period ID.
- **Update an Employment**: - This endpoint enables the update of an Employment resource.
- **Update a Person**: - This endpoint enables the update of a Person resource.
- **Update a Project**: Update a project by given project ID.
- **Update a webhook**: Update a webhook.
- **Update document metadata**: Updates the metadata of the Document with the provided Document ID.
- **Upload a document**: Uploads a document to be attached to an application, and returns a file reference (`uuid`, `size`, `mimetype`, `original_filename`, `extension`) that can be used to create or update an application.
- **Upload Document (v1)**: (v1, no v2 equivalent) This endpoint is responsible for uploading documents for the company employees.

Connect Personio in General Input: https://www.generalinput.com/apps/personio