Update a customer

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://rest-api.developer.24sevenoffice.com/doc/v1/mcp

Standard setup for AI tools providing an mcp.json file

{
  "v1 MCP server": {
    "url": "https://rest-api.developer.24sevenoffice.com/doc/v1/mcp"
  }
}

PATCH /customers/{customerId}

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

customerId integer(int32) Required

A unique identifier for the customer within Finago Office CRM.

application/json

Body Required

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.
name string | null

A human-readable name or label for a customer, making it easily identifiable to users.
organizationNumber string | null

The organization number issued by authorities, like a VAT number, of the customer if the customer is a company.
externalReference string | null

An optional field for referencing the customer with an ID from an external system, like an ERP or invoicing system.

Maximum length is 100.
isSupplier boolean

A flag variable indicating whether the customer is also a supplier (true) or not (false).
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.
mobilePhone string | null

A mobile phone number for contacting the customer.

Maximum length is 25.
note string | null

A free-text note about the customer.

Maximum length is 10000.

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 Finago Office 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.
- externalReference string | null
  
  An optional field for referencing the customer with an ID from an external system, like an ERP or invoicing system.
  
  Maximum length is 100.
- pricelistId integer
  
  The ID of the pricelist associated with this customer for pricing.
- 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.
- mobilePhone string | null
  
  A mobile phone number for contacting the customer.
  
  Maximum length is 25.
- note string | null
  
  A free-text note about the customer.
  
  Maximum length is 10000.
- 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/{customerId}

curl \
 --request PATCH 'https://rest.api.24sevenoffice.com/v1/customers/{customerId}' \
 --header "Content-Type: application/json" \
 --header "Authorization: string" \
 --data '{
  "person": {
    "firstName": "John",
    "lastName": "Doe"
  },
  "name": "ABC Corporation",
  "organizationNumber": "123456789",
  "externalReference": "EXT-12345",
  "isSupplier": false,
  "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",
  "mobilePhone": "+47-98765432",
  "note": "Prefers to be contacted by email."
}'

Request examples

# Headers
Authorization: string

# Payload
{
  "person": {
    "firstName": "John",
    "lastName": "Doe"
  },
  "name": "ABC Corporation",
  "organizationNumber": "123456789",
  "externalReference": "EXT-12345",
  "isSupplier": false,
  "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",
  "mobilePhone": "+47-98765432",
  "note": "Prefers to be contacted by email."
}

Response examples (200)

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

# Payload
{
  "id": 12345,
  "name": "ABC Corporation",
  "externalReference": "EXT-12345",
  "pricelistId": 1,
  "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",
  "mobilePhone": "+47-98765432",
  "note": "Prefers to be contacted by email.",
  "createdAt": "2022-01-01 18:00:00.000Z",
  "modifiedAt": "2023-12-31 18:00:00.000Z"
}