--- title: "Update a Contact" method: PATCH path: "/v1/companies/{company_id}/contacts/{id}" tags: ["Contacts"] --- # Update a Contact `PATCH /v1/companies/{company_id}/contacts/{id}` Update an existing Contact. ## Path parameters - `company_id` string, uuid, required - `id` string, uuid, required ## Request body - ContactsUpdateContact - `acting_team_member` string, uuid, required — The Team Member ID performing this action. This will be displayed in the Routable Dashboard. - `allow_for_multiple_companies` boolean — If set to true, Routable will bypass the validation of unique email addresses and allow the Contact to be created even if the email address is already used by a Contact on another Company. - `default_contact_for_company_management` 'actionable' | 'read_only' | 'none' — This field controls how both the Routable Dashboard and API will autofill contacts for emails related to Company management such as inviting a Company to submit their payment information. - When set to `actionable`, the Contact will be able to take action on emails related to Company management. - When set to `read_only`, the Contact will only receive emails related to Company management. - When set to `none`, the Contact will not receive emails related to Company management. - `default_contact_for_payable_and_receivable` 'actionable' | 'read_only' | 'none' — This field controls how both the Routable Dashboard and API will autofill contacts for emails related to Payables and Receivables. - When set to `actionable`, the Contact will be able to take action on emails related to Payables and Receivables. - When set to `read_only`, the Contact will only receive emails related to Payables and Receivables. - When set to `none`, the Contact will not receive emails related to Payables and Receivables. - `is_archived` boolean — Whether the Contact is archived. - `email` string, email — The email for this Contact. Required if the `Company` is a `customer`. For Contacts attached to a business `Company` that is *not* a `customer`, at least one of `email`, `first_name`, `last_name` and `phone_number` is required. - `first_name` string — The first name of this Contact. Required if the the `Company` is of type `personal` and/or is a `customer`. For Contacts attached to a business `Company` that is *not* a `customer`, at least one of `email`, `first_name`, `last_name` and `phone_number` is required. - `last_name` string — The last name of this Contact. Required if the the `Company` is of type `personal` and/or is a `customer`. For Contacts attached to a business `Company` that is *not* a `customer`, at least one of `email`, `first_name`, `last_name` and `phone_number` is required. - `phone_number` string — An E.164-formatted telephone number. ## Response `200` OK - ContactsContact - `object` 'Contact', required — The object’s type (`Contact`). - `id` string, uuid, required — The Contact ID. - `default_contact_for_company_management` 'actionable' | 'read_only' | 'none' | '' | 'self_managed', required — This field controls how both the Routable dashboard and API will autofill contacts for emails related to company management such as inviting a company to submit their payment information. - When set to `actionable`, the contact will be able to take action on emails related to company management. - When set to `read_only`, the contact will only receive emails related to company management. - When set to `none`, the contact will not receive emails related to company management. - `default_contact_for_payable_and_receivable` 'actionable' | 'read_only' | 'none' | '' | 'self_managed', required — This field controls how both the Routable dashboard and API will autofill contacts for emails related to payables and receivables. - When set to `actionable`, the contact will be able to take action on emails related to payables and receivables. - When set to `read_only`, the contact will only receive emails related to payables and receivables. - When set to `none`, the contact will not receive emails related to payables and receivables. - `email` string, email, nullable — The email for this contact. - `first_name` string — The first name of this contact. - `is_archived` boolean, required — Whether the contact is archived. - `last_email_delivery_problem` 'auto_responder' | 'hard_bounce' | 'refused' | 'soft_bounce' | 'spam_complaint' | 'spam_notification' | 'transient' | 'unknown', nullable — Describes an error that was encountered the last time an email was sent to this Contact via the Routable application. If the last email had no errors, this value will be `null`. | Value | Description | | ----------------- | -----------------------------------| | auto_responder | Automatic email responder (ex: "Out of Office" or "On Vacation"). | | hard_bounce | The server was unable to deliver your message (ex: unknown user, mailbox not found). | | refused | Email service has asked that the address not be used. Which could be because it is not a valid email address, or the recipient has requested an address change. | | soft_bounce | Temporarily unable to deliver the message (i.e. mailbox full, account disabled, exceeds quota, out of disk space). | | spam_complaint | The subscriber explicitly marked this message as spam. | | spam_notification | The message was delivered, but was either blocked by the user, or classified as spam, bulk mail, or had rejected content. | | transient | The server temporarily could not deliver your message (ex: Message is delayed due to network troubles). This may be re-tried and eventually resolve or become a different error.| | unknown | An unknown error occurred when sending the previous email. | - `last_name` string — The last name of this contact. - `phone_number` string, required — An E.164-formatted telephone number. - `phone_number_country` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'XK' | 'XX' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW', required — Country code in ISO 3166-1 Alpha-2 format. - `links` ContactsContactLinks, required — Related links. - `company` string, uri-reference, required — Link to this Contact's Company. - `invitation_url` string, uri — The URL for Company onboarding, generated by a call to the `Invite a Company` endpoint. - `self` string, uri-reference, required — Link to this object. --- [API](https://skmtc.net/routable/apis/routable-api.md) · [All operations](https://skmtc.net/routable/apis/routable-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/routable/routable-api/revisions/9f17a8bc982a/schema)