Skip to main content
POST
/
companies
Create a company
curl --request POST \
  --url https://sandbox.nmbr.co/services/payroll/companies \
  --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",
    "token": {
      "access_token": "<token>",
      "expires_in": 60,
      "expires_at": "2026-01-01T01: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.

Body

application/json
​
name
string
required

The company's name.

​
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

201 - application/json

Created

​
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