API Reference
Become a Partner

Create Compensation.

post
https://api.personio.de/v2/compensations

Requires credential with both personio:compensations:read and personio:compensations:write scopes.

Creates a compensation for people for an authorized company. Compensation types supported include one time, recurring, fixed, and hourly. Bonuses are not supported.

Body Params
person
object
required
type
object
required

The corresponding compensation. See Compensation Types for more details.

float
required

The amount of money in the currencies numeric unit, with up to two decimal places. For example, in case currency is EUR: * 20.50 - Twenty Euro and Fifty cents

string
enum

Supported currency following the ISO-4217 standard.

string
required

The effective start date of the compensation.

string
enum

The payout interval of the compensation. This field is mandatory for RECURRING compensations, if none is provided MONTHLY will be used by default. This field is ignored for ONE_TIME compensations. If the interval is YEARLY, the payout month will be the same as the one specified in the from field.

Allowed:
string

An optional comment about this compensation.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated 5 months ago

Language
Credentials
Bearer
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json
Updated 5 months ago