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"
}
'import requests
url = "https://sandbox.nmbr.co/services/payroll/companies/{company}"
payload = {
"name": "Cutting-Edge Telecom Solutions",
"pay_day_movement_setting": "inherit"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Cutting-Edge Telecom Solutions', pay_day_movement_setting: 'inherit'})
};
fetch('https://sandbox.nmbr.co/services/payroll/companies/{company}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.nmbr.co/services/payroll/companies/{company}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Cutting-Edge Telecom Solutions',
'pay_day_movement_setting' => 'inherit'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sandbox.nmbr.co/services/payroll/companies/{company}"
payload := strings.NewReader("{\n \"name\": \"Cutting-Edge Telecom Solutions\",\n \"pay_day_movement_setting\": \"inherit\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://sandbox.nmbr.co/services/payroll/companies/{company}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Cutting-Edge Telecom Solutions\",\n \"pay_day_movement_setting\": \"inherit\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.nmbr.co/services/payroll/companies/{company}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Cutting-Edge Telecom Solutions\",\n \"pay_day_movement_setting\": \"inherit\"\n}"
response = http.request(request)
puts response.read_body{
"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>"
}
}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"
}
'import requests
url = "https://sandbox.nmbr.co/services/payroll/companies/{company}"
payload = {
"name": "Cutting-Edge Telecom Solutions",
"pay_day_movement_setting": "inherit"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Cutting-Edge Telecom Solutions', pay_day_movement_setting: 'inherit'})
};
fetch('https://sandbox.nmbr.co/services/payroll/companies/{company}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.nmbr.co/services/payroll/companies/{company}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Cutting-Edge Telecom Solutions',
'pay_day_movement_setting' => 'inherit'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sandbox.nmbr.co/services/payroll/companies/{company}"
payload := strings.NewReader("{\n \"name\": \"Cutting-Edge Telecom Solutions\",\n \"pay_day_movement_setting\": \"inherit\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://sandbox.nmbr.co/services/payroll/companies/{company}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Cutting-Edge Telecom Solutions\",\n \"pay_day_movement_setting\": \"inherit\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.nmbr.co/services/payroll/companies/{company}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Cutting-Edge Telecom Solutions\",\n \"pay_day_movement_setting\": \"inherit\"\n}"
response = http.request(request)
puts response.read_body{
"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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
The company's name.
255The 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.
inherit, next_business_day, previous_business_day 255The locale used for payroll communications sent to Employees and Contractors within this company. If not set, the Partner's locale is used.
en, fr Response
OK
The unique identifier of the object in Nmbr.
The type of the object in Nmbr ("company").
Hide child attributes
Hide child attributes
The company's name.
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.
inherit, next_business_day, previous_business_day A reference to the object in an external system, e.g. the primary key of the object in your application's database. Nmbr doesn't use, validate, parse, or require this value to be unique - it simply stores it for your reference.
255The locale used for payroll communications sent to Employees and Contractors within this company. If not set, the Partner's locale is used.
en, fr The date and time the object was created in Nmbr.
The date and time the object was last updated in Nmbr.

