contacts

PUT /companies/{companySlug}/contacts/{contactId}

Changed on

Updates an existing contact.

Request

  • Base URL
    https://api.fiken.no/api/v2
  • URL
    https://api.fiken.no/api/v2/companies/{companySlug}/contacts/{contactId}
  • Auth
    OAuth 2
    Authorization code: https://fiken.no/oauth/authorize
    Token URL: https://fiken.no/oauth/token

Request body

contactIdinteger
createdDatestring date

Date that contact was created in Fiken, format yyyy-mm-dd.

lastModifiedDatestring date

Date that contact was last modified in Fiken, format yyyy-mm-dd.

namestring required
emailstring
organizationNumberstring

Brreg organization number.

customerNumberinteger
customerAccountCodestring

Format 1500:XXXXX

phoneNumberstring
memberNumbernumber

A number that can be used to connect a contact to your own data. This field is no longer used and instead memberNumberString should be used.

memberNumberStringstring

A number/id that can be used to connect a contact to your own data.

supplierNumberinteger
supplierAccountCodestring

Format 2400:XXXXX

customerboolean

True if the contact is a customer. It is possible for a contact to be both customer and supplier.

supplierboolean

True if the contact is a supplier. It is possible for a contact to be both supplier and customer.

bankAccountNumberstring
currencystring

ISO 4217 currency code. Default foreign currency to use when creating invoice to this contact (USD, EUR, SEK etc)

languagestring nullable

The language to use when sending documents to this contact. NORWEGIAN or ENGLISH. Defaults to NORWEGIAN.

inactiveboolean

Whether the contact has been deactivated (true) or is active (false)

daysUntilInvoicingDueDateinteger

Default number of days until due date for invoices.

discountnumber

Discount value should be a percent with a value between 0 and 100. Decimal values such as 25.5 are also allowed.

groupsstring[]

Example request

{
  "contactId": 2747365,
  "createdDate": "2018-04-03",
  "lastModifiedDate": "2018-04-03",
  "name": "Fiken AS",
  "email": "kontakt@fiken.gmail",
  "organizationNumber": "913312465",
  "customerNumber": 51248,
  "customerAccountCode": "1500:20001",
  "phoneNumber": "62158537",
  "memberNumber": 5464,
  "memberNumberString": "5464",
  "supplierAccountCode": "2400:20001",
  "bankAccountNumber": "11112233334",
  "contactPerson": [
    {
      "contactPersonId": 2747365,
      "name": "Betty Boop",
      "email": "bb@gmail.com",
      "phoneNumber": "98573564",
      "address": {
        "streetAddress": "Karl Johan 34",
        "streetAddressLine2": "H0405",
        "city": "Oslo",
        "postCode": "0550",
        "country": "Norway"
      }
    }
  ],
  "notes": [
    {
      "author": "Betty Boop",
      "note": "Garage 45"
    }
  ],
  "currency": "NOK",
  "language": "Norwegian",
  "inactive": true,
  "daysUntilInvoicingDueDate": 15,
  "discount": 25,
  "address": {
    "streetAddress": "Karl Johan 34",
    "streetAddressLine2": "H0405",
    "city": "Oslo",
    "postCode": "0550",
    "country": "Norway"
  },
  "documents": [
    {
      "uuid": "745b2f15-1234-4408-8bf2-b1d2d7610cb2",
      "filename": "invoice_24760.pdf",
      "identifier": "24760",
      "type": "invoice"
    }
  ]
}

Response

Updated

Changes

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • breaking

      the request property's minLength was increased from 0 to 1

    • warning

      the request property's maxLength was set to 11

    • warning

      the request property's maxLength was set to 200

    • warning

      the request property's maxLength was set to 200

    • warning

      the request property's maxLength was set to 200

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      request property deprecated