> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Personio Integration

> Automatic access to employee data via Personio for HR inquiries and internal communication during phone calls

# Personio Integration Template

Integrate Personio HR management into your Mid-call Actions for seamless access to employee data, leave status, and organizational information during internal and external calls.

## Overview & Features

<CardGroup cols={2}>
  <Card title="HR Data Access" icon="address-book">
    * Real-time employee data queries
    * Department and position information
    * Contact details and availability
    * Organizational structure navigation
  </Card>

  <Card title="HR Service Automation" icon="headset">
    * Quick employee verification
    * Leave status and absences
    * HR support assistance
    * Compliance and data protection integration
  </Card>
</CardGroup>

## Personio API Setup

### Configuration in the Famulor Interface

<Tabs>
  <Tab title="Tool Details">
    | Field                      | Value                                                                                                                |
    | -------------------------- | -------------------------------------------------------------------------------------------------------------------- |
    | **Name**\*                 | `Personio Mitarbeiter abrufen`                                                                                       |
    | **Description**            | "Retrieves employee data from Personio for HR support and internal communication"                                    |
    | **Function Name**\*        | `get_personio_employee`                                                                                              |
    | **Function Description**\* | "Retrieves employee data from Personio. Use this for HR inquiries, employee verification, or internal coordination." |
    | **HTTP Method**            | `GET`                                                                                                                |
    | **Timeout (ms)**           | `5000`                                                                                                               |
    | **Endpoint**\*             | `https://api.personio.de/v1/company/employees/{employee_id}`                                                         |
  </Tab>

  <Tab title="Header Configuration">
    ```json theme={null}
    {
      "Authorization": "Bearer {{PERSONIO_TOKEN}}",
      "X-Personio-Partner-ID": "{{PERSONIO_PARTNER_ID}}",
      "Content-Type": "application/json"
    }
    ```
  </Tab>
</Tabs>

### Parameter Schema

```json theme={null}
{
  "type": "object",
  "properties": {
    "employee_id": {
      "type": "integer",
      "description": "Personio employee ID"
    }
  },
  "required": ["employee_id"]
}
```

### Response Mapping

```json theme={null}
{
  "name": "data.attributes.first_name.value",
  "department": "data.attributes.department.value", 
  "position": "data.attributes.position.value",
  "email": "data.attributes.email.value"
}
```

***

<Tip>
  Related pages: [Introduction](/en/automation-platform/introduction) and [Building Flows](/en/automation-platform/building-flows), and [Debugging Runs](/en/automation-platform/debugging-runs).
</Tip>

<Tip>
  Need a whole toolset instead of building HTTP actions one by one? Connect an external **MCP server** — tools are discovered automatically. See [MCP Servers](/en/platform/mcp-servers).
</Tip>