---
title: "Update a contact"
method: PATCH
path: "/contacts/{id}"
tags: ["Contacts"]
---

# Update a contact

`PATCH /contacts/{id}`

## Request

- Base URL: `https://api.surense.com/api/v1`
- URL: `https://api.surense.com/api/v1/contacts/{id}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.surense.com/oauth/token` scopes: `contacts:update`

## Path parameters

- `id` string, uuid, required

## Request body

- UpdateContactRequest: Request to update a contact
  - `shared` boolean: Whether the contact is shared
  - `companyId` integer: Company ID
  - `employerId` string: Employer ID
  - `description` string: Contact description
  - `firstName` string: First name
  - `lastName` string: Last name
  - `role` string: Role/position
  - `phoneNumber1` string: Phone number 1
  - `phoneNumber2` string: Phone number 2
  - `extensionNumber` string: Extension number
  - `faxNumber` string: Fax number
  - `email1` string: Email address 1
  - `email2` string: Email address 2
  - `notes` string: Notes

## Response `200`

OK

- ContactValue
  - `tenantId` string, uuid
  - `agencyId` string, uuid
  - `createdDate` string, date-time
  - `createdBy` string, uuid
  - `creatorName` string
  - `lastModifiedDate` string, date-time
  - `lastModifiedBy` string, uuid
  - `version` integer
  - `id` string, uuid
  - `shared` boolean
  - `groupId` string, uuid
  - `companyId` integer
  - `companyName` string
  - `employerId` string, uuid
  - `employerName` string
  - `description` string
  - `firstName` string
  - `lastName` string
  - `fullName` string
  - `role` string
  - `phoneNumber1` string
  - `phoneNumber2` string
  - `extensionNumber` string
  - `faxNumber` string
  - `email1` string
  - `email2` string
  - `emails` string[]
  - `notes` string
  - `customFields` SmartDialogFieldValue[]
    - `fieldId` string, uuid
    - `type` integer
    - `value` object
  - `editable` boolean
  - `deletable` boolean

---

[API](https://skmtc.dev/surense/apis/contact-api.md) - [All operations](https://skmtc.dev/surense/apis/contact-api/llms.txt) - [OpenAPI document](https://skmtc.dev/surense/apis/contact-api/revisions/bbbc5c0f879a?raw)