--- title: "Update a single Contact" method: PATCH path: "/contacts/{id}.json" tags: ["Contacts"] --- # Update a single Contact `PATCH /contacts/{id}.json` Outlines the parameters and data fields used when updating a single Contact ## Path parameters - `id` integer, required ## Query parameters - `custom_field_ids[]` integer - `fields` string ## Headers - `IF-MATCH` string - `X-API-VERSION` string ## Request body - object - `data` object, required - `addresses` object[] - `name` 'Work' | 'Home' | 'Billing' | 'Other' — Name of the Address. - `street` string — Street. - `city` string — City. - `province` string — Province or state. - `postal_code` string — Postal code or zip code. - `country` string — Country - `id` integer — The unique identifier for a single Address associated with the Contact. The keyword `null` is not valid for this field. - `_destroy` boolean — The destroy flag. If the flag is set to `true` and the unique identifier of the associated Address is present, the Address is deleted from the Contact. - `avatar` object - `image` string — The avatar image for the *Contact*, base64-encoded. Must be a valid GIF, JPG, or PNG image of less than 2 megabytes in size. - `_destroy` boolean — The destroy flag. If the flag is set to `true` and the unique identifier of the associated Avatar is present, the Avatar is deleted from the Contact. - `clio_connect_email` string — Notifications will be sent to this email when a resource is shared. - `co_counsel_rate` object - `rate` number, double — Billing rate if the Contact is a co-counsel. Note: this value can only be provided during PATCH requests. It cannot be provided at the time a Contact is created (i.e. POST requests). - `company` object - `id` integer — The unique identifier for a single Company associated with the Contact. The keyword `null` is not valid for this field. - `currency` object — The Currency the contact is associated with. - `custom_field_set_associations` object[] - `id` integer — The unique identifier for a single CustomFieldSetAssociation associated with the Contact. The keyword `null` is not valid for this field. - `display_order` integer — The order to display the CustomFieldSet in a Contact. If not specified, it is added as the last CustomFieldSet of the Contact. - `custom_field_set` object - `id` integer — The unique identifier for a single CustomFieldSet associated with the CustomFieldSetAssociation. The keyword `null` is not valid for this field. - `_destroy` boolean — The destroy flag. If the flag is set to `true` and the unique identifier of the associated CustomFieldSetAssociation is present, the CustomFieldSetAssociation is deleted from the Contact. - `custom_field_values` object[] - `value` string — The value of the CustomFieldValue. - `custom_field` object - `id` integer — The unique identifier for a single CustomField associated with the CustomFieldValue. The keyword `null` is not valid for this field. - `id` string — The unique identifier for a single CustomFieldValue associated with the Contact. The keyword `null` is not valid for this field. - `_destroy` boolean — The destroy flag. If the flag is set to `true` and the unique identifier of the associated CustomFieldValue is present, the CustomFieldValue is deleted from the Contact. - `date_of_birth` string, date — Date of birth of the Contact. - `email_addresses` object[] - `id` integer — The unique identifier for a single EmailAddress associated with the Contact. The keyword `null` is not valid for this field. - `name` 'Work' | 'Home' | 'Other' — Name of the EmailAddress. - `address` string — Email address. - `default_email` boolean — Whether or not the Contact should be the default email for the Contact. - `_destroy` boolean — The destroy flag. If the flag is set to `true` and the unique identifier of the associated EmailAddress is present, the EmailAddress is deleted from the Contact. - `first_name` string — First name of the Contact. - `instant_messengers` object[] - `name` 'Work' | 'Personal' | 'Other' — Name of the InstantMessenger. - `address` string — Address of the InstantMessenger. - `id` integer — The unique identifier for a single InstantMessenger associated with the Contact. The keyword `null` is not valid for this field. - `_destroy` boolean — The destroy flag. If the flag is set to `true` and the unique identifier of the associated InstantMessenger is present, the InstantMessenger is deleted from the Contact. - `kyc_field_values` object[] - `id` integer — The unique identifier for a single KycFieldValue associated with the Contact. The keyword `null` is not valid for this field. - `field_name` string — The name of the KYC/KYB field. KYC/KYB fields are available for eligible accounts in Australia, Canada, Channel Islands, Ireland, Isle of Man, New Zealand, and United Kingdom. - `field_type` 'date' | 'text' | 'picklist' — The type of the KYC/KYB field. Must be one of: date, text, picklist. - `field_value` string — The value of the KYC/KYB field. - `last_name` string — Last name of the Contact. - `ledes_client_id` string — LEDES client id of the Contact. - `middle_name` string — Middle name of the Contact. - `name` string — Full name of the Contact. For requirements, see [Contact Name](https://docs.developers.clio.com/clio-manage/api-reference/#tag/Contacts/Contact-Name). - `phone_numbers` object[] - `name` 'Work' | 'Home' | 'Mobile' | 'Fax' | 'Pager' | 'Skype' | 'Other' — Name of the PhoneNumber. - `number` string — Phone number. - `default_number` boolean — Whether or not the PhoneNumber should be the default number for the Contact. - `id` integer — The unique identifier for a single PhoneNumber associated with the Contact. The keyword `null` is not valid for this field. - `_destroy` boolean — The destroy flag. If the flag is set to `true` and the unique identifier of the associated PhoneNumber is present, the PhoneNumber is deleted from the Contact. - `prefix` string — Personal title of the Contact. - `rate_table_assignment` object - `rate_table_id` integer — The unique identifier for a single RateTableAssignment associated with the Contact. The keyword `null` is not valid for this field. - `rate_table_category_id` integer — The unique identifier for a single RateTableAssignment associated with the Contact. The keyword `null` is not valid for this field. - `require_utbms_codes` boolean — When true, new matters created for this Contact default to requiring UTBMS/LEDES codes on billable time and expense entries. Requires the firm to have mandatory LEDES billing enabled; otherwise the value is ignored. - `sales_tax_number` string — A contact's sales tax number will appear on invoices generated for the Contact. - `title` string — Professional title of the Contact. - `type` 'Person' | 'Company' — Type of the Contact. - `web_sites` object[] - `name` 'Work' | 'Personal' | 'Twitter' | 'Facebook' | 'LinkedIn' | 'Instant Messenger' | 'Other' — Name of the WebSite. - `address` string — URL of the WebSite. - `id` integer — The unique identifier for a single WebSite associated with the Contact. The keyword `null` is not valid for this field. - `default_web_site` boolean — Whether or not the Contact should be the default website for the Contact. - `_destroy` boolean — The destroy flag. If the flag is set to `true` and the unique identifier of the associated WebSite is present, the WebSite is deleted from the Contact. ## Response `200` Ok ## Other responses - `400` — Bad Request - `401` — Unauthorized - `403` — Forbidden - `404` — Not Found - `412` — Precondition Failed - `422` — Unprocessable Entity - `429` — Too Many Requests --- [API](https://skmtc.net/clio/apis/clio-api-documentation.md) · [All operations](https://skmtc.net/clio/apis/clio-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clio/clio-api-documentation/versions/94a82114ec3b/schema)