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.
user[show_optional_fields]
optional , nil allowed

Defaults to true

Validations:

  • Must be one of: true, false.
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[settings_attributes]
optional , nil allowed

Validations:

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

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_code]
optional , nil allowed

Validations:

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

Validations:

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

Validations:

  • Must be a String
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][on_vacation]
optional , nil allowed

Defaults to false

Validations:

  • Must be one of: true, false.
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.
user[settings_attributes][password_auth_disabled]
optional , nil allowed

Enforce SSO authentication

Validations:

  • Must be one of: true, false.
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.
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
skip_notification
optional

Skip sending invitation notification. Defaults to “false”

Validations:

  • Must be one of: true, false.