POST /api/users
Add new user

Add new user and set his current company settings

Params

Param name Description
user
required

User params

Validations:

  • Must be a Hash
user[name]
required

User full name

Validations:

  • Must be a String
user[email]
required

Validations:

  • Must be a String
user[ssn]
optional , nil allowed

User’s Social Security Number

Validations:

  • Must be a String
user[iban]
optional , nil allowed

IBAN

Validations:

  • Must be a String
user[bic]
optional , nil allowed

BIC

Validations:

  • Must be a String
user[locale]
optional , nil allowed

Validations:

  • Must be one of: en, fi, sv.
user[send_reminder_emails]
optional , nil allowed

Defaults to true

Validations:

  • Must be one of: true, false, 1, 0.
user[country_id]
optional , nil allowed

Country id of a user. Determines default user currency in UI.

Validations:

  • Must be a Integer
user[nationality_id]
optional , nil allowed

Country id of a user’s . Dictates SSN validation rules.

Validations:

  • Must be a Integer
user[gender]
optional , nil allowed

Legal Gender. We support LGBTI Rights, but are constrained by the Tax Authorities in terms of which Gender alternatives we can report to them. We will update the alternatives as soon as we are allowed to do so.

Validations:

  • Must be one of: female, male.
user[birthday]
optional , nil allowed

User birthday

Validations:

  • Must be a String
user[roles]
optional , nil allowed

An array of user roles. Can be one of a few of the following: “employee”, “manager”, “accountant”, “approver”, “money_checker”. Only the managers can update roles.

Validations:

  • Must be an array of String
user[employment_termination_date]
optional , nil allowed

Employment termination date, e.g. “2023-01-14”. User will be automatically removed from the company after that date.

Validations:

  • Must be a String
user[on_vacation]
optional , nil allowed

Defaults to false

Validations:

  • Must be one of: true, false, 1, 0.
user[vacation_start_date]
optional , nil allowed

User vacation start date: on the start of that date on_vacation setting will be set to true automatically.

Validations:

  • Must be a String
user[vacation_end_date]
optional , nil allowed

User vacation end date: the next day after that date on_vacation setting will be set to false automatically.

Validations:

  • Must be a String
user[political_party_id]
optional , nil allowed

ID of a political party the user is a member of. Used for political party tax deduction.

Validations:

  • Must be a Integer
user[settings_attributes]
optional , nil allowed

Validations:

  • Must be an Array of nested elements
user[settings_attributes][default_cost_centers]
optional , nil allowed

User’s default cost centers. Format: {"DIMENSION_NAME":COST_CENTER_ID,...}, e.g. {"Office":123,"Project":456}.

Validations:

  • Must be a Hash
user[settings_attributes][default_asset_account_id]
optional , nil allowed

Validations:

  • Must be a Integer
user[settings_attributes][default_expense_account_id]
optional , nil allowed

Validations:

  • Must be a Integer
user[settings_attributes][mileage_vehicle_category_id]
optional , nil allowed

Validations:

  • Must be a Integer
user[settings_attributes][allowance_country_category_id]
optional , nil allowed

Validations:

  • Must be a Integer
user[settings_attributes][allowance_account_id]
optional , nil allowed

Validations:

  • Must be a Integer
user[settings_attributes][allowance_abroad_account_id]
optional , nil allowed

Validations:

  • Must be a Integer
user[settings_attributes][mileage_account_id]
optional , nil allowed

Validations:

  • Must be a Integer
user[settings_attributes][ir_mileage_code]
optional , nil allowed

Validations:

  • Must be a Integer
user[settings_attributes][ir_daily_allowance_code]
optional , nil allowed

Validations:

  • Must be a Integer
user[settings_attributes][reimbursement_account_code]
optional , nil allowed

Validations:

  • Must be a String
user[settings_attributes][stand_in_approver_id]
optional , nil allowed

Stand-in user_id, should be different from user_id

Validations:

  • Must be a Integer
user[settings_attributes][send_data_to_incomes_register]
optional , nil allowed

Validations:

  • Must be one of: true, false, 1, 0.
user[settings_attributes][password_auth_disabled]
optional , nil allowed

Enforce SSO authentication

Validations:

  • Must be one of: true, false, 1, 0.
user[settings_attributes][work_time_group_id]
optional , nil allowed

Work-time group ID

Validations:

  • Must be a Integer
user[approvers_attributes]
optional , nil allowed

Add/Remove user approvers. Current user should have “manager” role to edit approvers

Validations:

  • Must be an Array of nested elements
user[approvers_attributes][id]
optional , nil allowed

User approver id, required if user approver already exists. If it’s not supplied, new user approver will be added

Validations:

  • Must be a Integer
user[approvers_attributes][approver_id]
required

Approver id

Validations:

  • Must be a Integer
user[approvers_attributes][operator]
required

Operator specifying approver process logic

Validations:

  • Must be one of: then, or.
user[approvers_attributes][_destroy]
optional , nil allowed

Pass “true” here to delete an existing approver

Validations:

  • Must be one of: true, false, 1, 0.
user[current_tax_card]
optional , nil allowed

Validations:

  • Must be a Hash
user[current_tax_card][tax_percentage]
optional , nil allowed

User’s current tax card tax percentage, must be either less than 100 (e.g. 25 for 25%) or less than 1 (e.g. 0.34 for 34%)

Validations:

  • Must be a Float
user[address_attributes]
optional , nil allowed

User address

Validations:

  • Must be a Hash
user[address_attributes][street]
optional , nil allowed

Street address.

Validations:

  • Must be a String
user[address_attributes][city]
optional , nil allowed

City of the address, or Post Office.

Validations:

  • Must be a String
user[address_attributes][postal_code]
optional , nil allowed

Postal Code of the address.

Validations:

  • Must be a String
user[address_attributes][country_id]
optional , nil allowed

Country id of an address.

Validations:

  • Must be a Integer
user[address_attributes][latitude]
optional , nil allowed

Geographic Latitude from Google Maps

Validations:

  • Must be a decimal number.
user[address_attributes][longitude]
optional , nil allowed

Geographic Longitude from Google Maps

Validations:

  • Must be a decimal number.
skip_notification
optional

Skip sending invitation notification. Defaults to “false”

Validations:

  • Must be one of: true, false, 1, 0.