Skip to main content
PUT
/
companies
/
{company}
Update a company
curl --request PUT \
  --url https://sandbox.nmbr.co/services/payroll/companies/{company} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Cutting-Edge Telecom Solutions",
  "pay_day_movement_setting": "inherit"
}
'
{
  "id": "<id>",
  "object": "company",
  "data": {
    "name": "Cutting-Edge Telecom Solutions",
    "pay_day_movement_setting": "inherit",
    "external_ref": null,
    "preferred_locale": null,
    "created_at": "2026-01-01T00:00:00.000000Z",
    "updated_at": "2026-01-01T00:00:00.000000Z"
  },
  "links": {
    "self": "/companies/<id>"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
company
string
required

Body

application/json
​
name
string

The company's name.

Maximum string length: 255
​
pay_day_movement_setting
enum<string>

The company-level setting for how pay dates are adjusted when they fall on a weekend or bank holiday. Inherited by Business Entities and Pay Schedules whose own setting is inherit.

Available options:
inherit,
next_business_day,
previous_business_day
​
external_ref
string
Maximum string length: 255
​
preferred_locale
enum<string>

The locale used for payroll communications sent to Employees and Contractors within this company. If not set, the Partner's locale is used.

Available options:
en,
fr

Response

200 - application/json

OK

​
id
string
read-only

The unique identifier of the object in Nmbr.

​
object
string
read-only

The type of the object in Nmbr ("company").

​
data
Company · object