---
title: "Update a existing contact"
method: PUT
path: "/Contact/{contactId}"
tags: ["Contact"]
---

# Update a existing contact

`PUT /Contact/{contactId}`

Update a contact

## Path parameters

- `contactId` integer, required

## Request body

- ModelContactUpdate — Contact model
  - `name` string, nullable — The organization name.<br> Be aware that the type of contact will depend on this attribute.<br> If it holds a value, the contact will be regarded as an organization.
  - `status` integer, nullable — Defines the status of the contact. 100 <-> Lead - 500 <-> Pending - 1000 <-> Active.
  - `customerNumber` string, nullable — The customer number
  - `parent` object, nullable — The parent contact to which this contact belongs. Must be an organization.
    - `id` integer, required — Unique identifier of the parent contact
    - `objectName` string, required — Model name, which is 'Contact'
  - `surename` string, nullable — The <b>first</b> name of the contact.<br> Yeah... not quite right in literally every way. We know.<br> Not to be used for organizations.
  - `familyname` string, nullable — The last name of the contact.<br> Not to be used for organizations.
  - `titel` string, nullable — A non-academic title for the contact. Not to be used for organizations.
  - `category` object, nullable — Category of the contact.<br> For more information, see <a href='https://my.sevdesk.de/apiOverview/index.html#/doc-contacts#types'>here</a>.
    - `id` integer, required — Unique identifier of the category
    - `objectName` string, required — Model name, which is 'Category'
  - `description` string, nullable — A description for the contact.
  - `academicTitle` string, nullable — A academic title for the contact. Not to be used for organizations.
  - `gender` string, nullable — Gender of the contact.<br> Not to be used for organizations.
  - `name2` string, nullable — Second name of the contact.<br> Not to be used for organizations.
  - `birthday` string, date, nullable — Birthday of the contact.<br> Not to be used for organizations.
  - `vatNumber` string, nullable — Vat number of the contact.
  - `bankAccount` string, nullable — Bank account number (IBAN) of the contact.
  - `bankNumber` string, nullable — Bank number of the bank used by the contact.
  - `defaultCashbackTime` integer, nullable — Absolute time in days which the contact has to pay his invoices and subsequently get a cashback.
  - `defaultCashbackPercent` number, float, nullable — Percentage of the invoice sum the contact gets back if he paid invoices in time.
  - `defaultTimeToPay` integer, nullable — The payment goal in days which is set for every invoice of the contact.
  - `taxNumber` string, nullable — The tax number of the contact.
  - `taxOffice` string, nullable — The tax office of the contact (only for greek customers).
  - `exemptVat` boolean, nullable — Defines if the contact is freed from paying vat.
  - `defaultDiscountAmount` number, float, nullable — The default discount the contact gets for every invoice.<br> Depending on defaultDiscountPercentage attribute, in percent or absolute value.
  - `defaultDiscountPercentage` boolean, nullable — Defines if the discount is a percentage (true) or an absolute value (false).
  - `buyerReference` string, nullable — Buyer reference of the contact.
  - `governmentAgency` boolean, nullable — Defines whether the contact is a government agency (true) or not (false).

## Response `200`

Successful operation - Returns changed contact resource

- ModelContactResponse — Contact model
  - `id` string — The contact id
  - `objectName` string — The contact object name
  - `create` string, date-time — Date of contact creation
  - `update` string, date-time — Date of last contact update
  - `name` string — The organization name.<br> Be aware that the type of contact will depend on this attribute.<br> If it holds a value, the contact will be regarded as an organization.
  - `status` string — Defines the status of the contact. 100 <-> Lead - 500 <-> Pending - 1000 <-> Active.
  - `customerNumber` string — The customer number
  - `parent` object — The parent contact to which this contact belongs. Must be an organization.
    - `id` string, required — Unique identifier of the parent contact
    - `objectName` string, required — Model name, which is 'Contact'
  - `surename` string — The <b>first</b> name of the contact.<br> Yeah... not quite right in literally every way. We know.<br> Not to be used for organizations.
  - `familyname` string — The last name of the contact.<br> Not to be used for organizations.
  - `titel` string — A non-academic title for the contact. Not to be used for organizations.
  - `category` object — Category of the contact.<br> For more information, see <a href='https://my.sevdesk.de/apiOverview/index.html#/doc-contacts#types'>here</a>.
    - `id` string, required — Unique identifier of the category
    - `objectName` string, required — Model name, which is 'Category'
  - `description` string — A description for the contact.
  - `academicTitle` string — A academic title for the contact. Not to be used for organizations.
  - `gender` string — Gender of the contact.<br> Not to be used for organizations.
  - `sevClient` object — Client to which contact belongs. Will be filled automatically
    - `id` integer, required — Unique identifier of the client
    - `objectName` string, required — Model name, which is 'SevClient'
  - `name2` string — Second name of the contact.<br> Not to be used for organizations.
  - `birthday` string, date — Birthday of the contact.<br> Not to be used for organizations.
  - `vatNumber` string — Vat number of the contact.
  - `bankAccount` string — Bank account number (IBAN) of the contact.
  - `bankNumber` string — Bank number of the bank used by the contact.
  - `defaultCashbackTime` string — Absolute time in days which the contact has to pay his invoices and subsequently get a cashback.
  - `defaultCashbackPercent` string, float — Percentage of the invoice sum the contact gets back if he paid invoices in time.
  - `defaultTimeToPay` string — The payment goal in days which is set for every invoice of the contact.
  - `taxNumber` string — The tax number of the contact.
  - `taxOffice` string — The tax office of the contact (only for greek customers).
  - `exemptVat` string — Defines if the contact is freed from paying vat.
  - `defaultDiscountAmount` string, float — The default discount the contact gets for every invoice.<br> Depending on defaultDiscountPercentage attribute, in percent or absolute value.
  - `defaultDiscountPercentage` string — Defines if the discount is a percentage (true) or an absolute value (false).
  - `buyerReference` string — Buyer reference of the contact.
  - `governmentAgency` string — Defines whether the contact is a government agency (true) or not (false).
  - `additionalInformation` string — Additional information stored for the contact.

## Other responses

- `400` — Bad request
- `401` — Authentication required
- `500` — Server Error

---

[API](https://skmtc.net/sevdesk/apis/sevdesk-api.md) · [All operations](https://skmtc.net/sevdesk/apis/sevdesk-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sevdesk/sevdesk-api/revisions/a32cec0fecea/schema)