Update a customer

PATCH /customers/{id}

Tfso

Update details of a specific customer identified by its uinque customer ID, and receive the updated details in return.

Headers

Authorization string Required

Authorization header

Path parameters

id integer(int32) Required

A unique identifier for the customer within 24SevenOffice CRM.

application/json

Body Required

name string | null

A human-readable name or label for a customer, making it easily identifiable to users.
person object

The first and the last name of a customer if the customer is a person.
Hide person attributes Show person attributes object
- firstName string | null
  
  The first name of a person if the customer is a person.
- lastName string | null
  
  The last name of a person if the customer is a person.
isSupplier boolean

A flag variable indicating whether the customer is also a supplier (true) or not (false).
organizationNumber string | null

The organization number issued by authorities, like a VAT number, of the customer if the customer is a company.
address object

Addresses for the customer.
Hide address attributes Show address attributes object
- visit object
  
  The visiting address of the customer.
  Hide visit attributes Show visit attributes object
  
  countryCode string | null
  
  The two-letter country code for the address, as in ISO 3166-1 alpha-2 standard.
  
  Maximum length is 2.
  
  street string | null
  
  The street for the address. Can contain a street name, building and apartment number, a PO box number, or similar.
  
  postalCode string | null
  
  The postal code for the address.
  
  postalArea string | null
  
  The postal area for the address.
  
  countrySubdivision string | null
  
  The geographical subdivision for the address, like a county ("fylke" in Norway) or a state.
- postal object
  
  The postal address of the customer.
  Hide postal attributes Show postal attributes object
  
  street string | null
  
  The street for the address. Can contain a street name, building and apartment number, a PO box number, or similar.
  
  postalCode string | null
  
  The postal code for the address.
  
  postalArea string | null
  
  The postal area for the address.
  
  countrySubdivision string | null
  
  The geographical subdivision for the address, like a county ("fylke" in Norway) or a state.
- billing object
  
  The billing address of the customer.
  Hide billing attributes Show billing attributes object
  
  name string | null
  
  The name for the address.
  
  countryCode string | null
  
  The two-letter country code for the address, as in ISO 3166-1 alpha-2 standard.
  
  Maximum length is 2.
  
  street string | null
  
  The street for the address. Can contain a street name, building and apartment number, a PO box number, or similar.
  
  postalCode string | null
  
  The postal code for the address.
  
  postalArea string | null
  
  The postal area for the address.
  
  countrySubdivision string | null
  
  The geographical subdivision for the address, like a county ("fylke" in Norway) or a state.
- delivery object
  
  The delivery address of the customer.
  Hide delivery attributes Show delivery attributes object
  
  name string | null
  
  The name for the address.
  
  countryCode string | null
  
  The two-letter country code for the address, as in ISO 3166-1 alpha-2 standard.
  
  Maximum length is 2.
  
  street string | null
  
  The street for the address. Can contain a street name, building and apartment number, a PO box number, or similar.
  
  postalCode string | null
  
  The postal code for the address.
  
  postalArea string | null
  
  The postal area for the address.
  
  countrySubdivision string | null
  
  The geographical subdivision for the address, like a county ("fylke" in Norway) or a state.
email object

Email addresses for the customer.
Hide email attributes Show email attributes object
- contact string | null
  
  The email address for contacting the customer.
- billing string | null
  
  The billing email address for the customer.
phone string | null

A phone number for contacting the customer.

Responses

200 application/json

Success
Hide headers attributes Show headers attributes
- Access-Control-Allow-Origin string
- Access-Control-Allow-Credentials string
- X-Trace-Id string
Hide response attributes Show response attributes object
- id integer(int32)
  
  A unique identifier for the customer within 24SevenOffice CRM. This ID is used for reference and linking transactions to specific customers.
- name string | null
  
  A human-readable name or label for a customer, making it easily identifiable to users.
- person object
  
  The first and the last name of a customer if the customer is a person.
  
  Hide person attributes Show person attributes object
  
  firstName string | null
  
  The first name of a person if the customer is a person.
  
  lastName string | null
  
  The last name of a person if the customer is a person.
- isCompany boolean
  
  A flag variable indicating whether the customer is a company (true) or a person (false).
- isSupplier boolean
  
  A flag variable indicating whether the customer is also a supplier (true) or not (false).
- organizationNumber string | null
  
  The organization number issued by authorities, like a VAT number, of the customer if the customer is a company.
- address object
  
  Addresses for the customer.
  
  Hide address attributes Show address attributes object
  
  visit object
  
  The visiting address of the customer.
  
  Hide visit attributes Show visit attributes object
  
  countryCode string | null
  
  The two-letter country code for the address, as in ISO 3166-1 alpha-2 standard.
  
  Maximum length is 2.
  
  street string | null
  
  The street for the address. Can contain a street name, building and apartment number, a PO box number, or similar.
  
  postalCode string | null
  
  The postal code for the address.
  
  postalArea string | null
  
  The postal area for the address.
  
  countrySubdivision string | null
  
  The geographical subdivision for the address, like a county ("fylke" in Norway) or a state.
  
  postal object
  
  The postal address of the customer.
  
  Hide postal attributes Show postal attributes object
  
  street string | null
  
  The street for the address. Can contain a street name, building and apartment number, a PO box number, or similar.
  
  postalCode string | null
  
  The postal code for the address.
  
  postalArea string | null
  
  The postal area for the address.
  
  countrySubdivision string | null
  
  The geographical subdivision for the address, like a county ("fylke" in Norway) or a state.
  
  billing object
  
  The billing address of the customer.
  
  Hide billing attributes Show billing attributes object
  
  name string | null
  
  The name for the address.
  
  countryCode string | null
  
  The two-letter country code for the address, as in ISO 3166-1 alpha-2 standard.
  
  Maximum length is 2.
  
  street string | null
  
  The street for the address. Can contain a street name, building and apartment number, a PO box number, or similar.
  
  postalCode string | null
  
  The postal code for the address.
  
  postalArea string | null
  
  The postal area for the address.
  
  countrySubdivision string | null
  
  The geographical subdivision for the address, like a county ("fylke" in Norway) or a state.
  
  delivery object
  
  The delivery address of the customer.
  
  Hide delivery attributes Show delivery attributes object
  
  name string | null
  
  The name for the address.
  
  countryCode string | null
  
  The two-letter country code for the address, as in ISO 3166-1 alpha-2 standard.
  
  Maximum length is 2.
  
  street string | null
  
  The street for the address. Can contain a street name, building and apartment number, a PO box number, or similar.
  
  postalCode string | null
  
  The postal code for the address.
  
  postalArea string | null
  
  The postal area for the address.
  
  countrySubdivision string | null
  
  The geographical subdivision for the address, like a county ("fylke" in Norway) or a state.
- email object
  
  Email addresses for the customer.
  
  Hide email attributes Show email attributes object
  
  contact string | null
  
  The email address for contacting the customer.
  
  billing string | null
  
  The billing email address for the customer.
- phone string | null
  
  A phone number for contacting the customer.
- createdAt string
  
  A timestamp for when a record was created, in ISO 8601 format.
- modifiedAt string
  
  A timestamp for when one of the properties of a record was last modified, in ISO 8601 format.
401

Unauthorized. Missing or invalid bearer token.
Hide headers attributes Show headers attributes
- Access-Control-Allow-Origin string
- Access-Control-Allow-Credentials string
- X-Trace-Id string

PATCH /customers/{id}

curl \
 --request PATCH 'https://rest.api.24sevenoffice.com/v1/customers/{id}' \
 --header "Content-Type: application/json" \
 --header "Authorization: string" \
 --data '{"name":"ABC Corporation","person":{"firstName":"John","lastName":"Doe"},"isSupplier":false,"organizationNumber":"123456789","address":{"visit":{"countryCode":"NO","street":"Hovedgata 1","postalCode":"0123","postalArea":"Fornebu","countrySubdivision":"Viken"},"postal":{"street":"Hovedgata 1","postalCode":"0123","postalArea":"Fornebu","countrySubdivision":"Viken"},"billing":{"name":"ABC Corporation","countryCode":"NO","street":"Hovedgata 1","postalCode":"0123","postalArea":"Fornebu","countrySubdivision":"Viken"},"delivery":{"name":"ABC Corporation","countryCode":"NO","street":"Hovedgata 1","postalCode":"0123","postalArea":"Fornebu","countrySubdivision":"Viken"}},"email":{"contact":"contact@example.com","billing":"billing@example.com"},"phone":"+47-12345678"}'

Request examples

# Headers
Authorization: string

# Payload
{
  "name": "ABC Corporation",
  "person": {
    "firstName": "John",
    "lastName": "Doe"
  },
  "isSupplier": false,
  "organizationNumber": "123456789",
  "address": {
    "visit": {
      "countryCode": "NO",
      "street": "Hovedgata 1",
      "postalCode": "0123",
      "postalArea": "Fornebu",
      "countrySubdivision": "Viken"
    },
    "postal": {
      "street": "Hovedgata 1",
      "postalCode": "0123",
      "postalArea": "Fornebu",
      "countrySubdivision": "Viken"
    },
    "billing": {
      "name": "ABC Corporation",
      "countryCode": "NO",
      "street": "Hovedgata 1",
      "postalCode": "0123",
      "postalArea": "Fornebu",
      "countrySubdivision": "Viken"
    },
    "delivery": {
      "name": "ABC Corporation",
      "countryCode": "NO",
      "street": "Hovedgata 1",
      "postalCode": "0123",
      "postalArea": "Fornebu",
      "countrySubdivision": "Viken"
    }
  },
  "email": {
    "contact": "contact@example.com",
    "billing": "billing@example.com"
  },
  "phone": "+47-12345678"
}

Response examples (200)

# Headers
Access-Control-Allow-Origin: string
Access-Control-Allow-Credentials: string
X-Trace-Id: string

# Payload
{
  "id": 12345,
  "name": "ABC Corporation",
  "person": {
    "firstName": "John",
    "lastName": "Doe"
  },
  "isCompany": true,
  "isSupplier": false,
  "organizationNumber": "123456789",
  "address": {
    "visit": {
      "countryCode": "NO",
      "street": "Hovedgata 1",
      "postalCode": "0123",
      "postalArea": "Fornebu",
      "countrySubdivision": "Viken"
    },
    "postal": {
      "street": "Hovedgata 1",
      "postalCode": "0123",
      "postalArea": "Fornebu",
      "countrySubdivision": "Viken"
    },
    "billing": {
      "name": "ABC Corporation",
      "countryCode": "NO",
      "street": "Hovedgata 1",
      "postalCode": "0123",
      "postalArea": "Fornebu",
      "countrySubdivision": "Viken"
    },
    "delivery": {
      "name": "ABC Corporation",
      "countryCode": "NO",
      "street": "Hovedgata 1",
      "postalCode": "0123",
      "postalArea": "Fornebu",
      "countrySubdivision": "Viken"
    }
  },
  "email": {
    "contact": "contact@example.com",
    "billing": "billing@example.com"
  },
  "phone": "+47-12345678",
  "createdAt": "2022-01-01 18:00:00.000Z",
  "modifiedAt": "2023-12-31 18:00:00.000Z"
}