---
title: "Update a contact"
method: PUT
path: "/accounting/{connection_id}/contact/{id}"
tags: ["accounting", "contact"]
---

# Update a contact

`PUT /accounting/{connection_id}/contact/{id}`

## Request

- Base URL: `http://api.unified.to`
- URL: `http://api.unified.to/accounting/{connection_id}/contact/{id}`
- Auth: API key in header `authorization`

## Path parameters

- `connection_id` string, required
- `id` string, required

## Query parameters

- `fields` string[]
- `raw` string

## Request body

- AccountingContact
  - `id` string
  - `created_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `updated_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `name` string
  - `first_name` string
  - `last_name` string
  - `emails` AccountingEmail[]
    - `email` string
    - `type` 'WORK' | 'HOME' | 'OTHER'
  - `telephones` AccountingTelephone[]
    - `telephone` string
    - `type` 'WORK' | 'HOME' | 'OTHER' | 'FAX' | 'MOBILE'
  - `currency` string
  - `billing_address` AccountingContactBillingAddress
    - `address1` string
    - `address2` string
    - `city` string
    - `region` string: Regional area of the employee's address. For example, in the U.S., the region is the employee's state; in Canada, the region is the employee’s province.
    - `region_code` string: Short form for the regional area of the employee's address. For example, in the U.S., the region code is the two-letter abbreviation for the employee’s state; in Canada, the region is the two-letter abbreviation for the employee's province.
    - `postal_code` string
    - `country` string
    - `country_code` string: Country code for the country, in ISO 3166 A-2 format
  - `shipping_address` AccountingContactShippingAddress
    - `address1` string
    - `address2` string
    - `city` string
    - `region` string: Regional area of the employee's address. For example, in the U.S., the region is the employee's state; in Canada, the region is the employee’s province.
    - `region_code` string: Short form for the regional area of the employee's address. For example, in the U.S., the region code is the two-letter abbreviation for the employee’s state; in Canada, the region is the two-letter abbreviation for the employee's province.
    - `postal_code` string
    - `country` string
    - `country_code` string: Country code for the country, in ISO 3166 A-2 format
  - `is_active` boolean
  - `tax_exemption` 'FEDERAL_GOV' | 'REGION_GOV' | 'LOCAL_GOV' | 'TRIBAL_GOV' | 'CHARITABLE_ORG' | 'RELIGIOUS_ORG' | 'EDUCATIONAL_ORG' | 'MEDICAL_ORG' | 'RESALE' | 'FOREIGN' | 'OTHER'
  - `tax_number` string: The ID/number of the customer's tax number. This is also known as the ABN (Australia), GST Number (New Zealand), VAT Number (UK) or Tax ID Number (US and global).
  - `is_customer` boolean
  - `is_supplier` boolean
  - `portal_url` string: URL for the contact’s portal
  - `payment_methods` AccountingContactPaymentMethod[]
    - `id` string
    - `type` 'ACH' | 'ALIPAY' | 'CARD' | 'GIROPAY' | 'IDEAL' | 'OTHER' | 'PAYPAL' | 'WIRE' | 'CHECK', required
    - `name` string
    - `default` boolean
  - `company_name` string
  - `identification` string: contact account numbers such as registration, A membership or identification reference to help to identify and search customers
  - `associated_contacts` AccountingAssociatedContact[]
    - `id` string
    - `name` string
    - `emails` AccountingEmail[]
      - `email` string
      - `type` 'WORK' | 'HOME' | 'OTHER'
  - `organization_id` string
  - `payment_terms` 'ON_RECEIPT' | 'NET_7' | 'NET_10' | 'NET_15' | 'NET_20' | 'NET_25' | 'NET_30' | 'NET_45' | 'NET_60' | 'NET_90' | 'OTHER'
  - `paymentterm_id` string
  - `balance_amount` number: Outstanding AR/AP balance for this contact
  - `website` string
  - `notes` string
  - `metadata` AccountingMetadata[]
    - `id` string
    - `slug` string
    - `value` unknown
    - `namespace` string
    - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
    - `extra_data` unknown
  - `raw` unknown

## Response `200`

Successful

- AccountingContact
  - `id` string
  - `created_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `updated_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `name` string
  - `first_name` string
  - `last_name` string
  - `emails` AccountingEmail[]
    - `email` string
    - `type` 'WORK' | 'HOME' | 'OTHER'
  - `telephones` AccountingTelephone[]
    - `telephone` string
    - `type` 'WORK' | 'HOME' | 'OTHER' | 'FAX' | 'MOBILE'
  - `currency` string
  - `billing_address` AccountingContactBillingAddress
    - `address1` string
    - `address2` string
    - `city` string
    - `region` string: Regional area of the employee's address. For example, in the U.S., the region is the employee's state; in Canada, the region is the employee’s province.
    - `region_code` string: Short form for the regional area of the employee's address. For example, in the U.S., the region code is the two-letter abbreviation for the employee’s state; in Canada, the region is the two-letter abbreviation for the employee's province.
    - `postal_code` string
    - `country` string
    - `country_code` string: Country code for the country, in ISO 3166 A-2 format
  - `shipping_address` AccountingContactShippingAddress
    - `address1` string
    - `address2` string
    - `city` string
    - `region` string: Regional area of the employee's address. For example, in the U.S., the region is the employee's state; in Canada, the region is the employee’s province.
    - `region_code` string: Short form for the regional area of the employee's address. For example, in the U.S., the region code is the two-letter abbreviation for the employee’s state; in Canada, the region is the two-letter abbreviation for the employee's province.
    - `postal_code` string
    - `country` string
    - `country_code` string: Country code for the country, in ISO 3166 A-2 format
  - `is_active` boolean
  - `tax_exemption` 'FEDERAL_GOV' | 'REGION_GOV' | 'LOCAL_GOV' | 'TRIBAL_GOV' | 'CHARITABLE_ORG' | 'RELIGIOUS_ORG' | 'EDUCATIONAL_ORG' | 'MEDICAL_ORG' | 'RESALE' | 'FOREIGN' | 'OTHER'
  - `tax_number` string: The ID/number of the customer's tax number. This is also known as the ABN (Australia), GST Number (New Zealand), VAT Number (UK) or Tax ID Number (US and global).
  - `is_customer` boolean
  - `is_supplier` boolean
  - `portal_url` string: URL for the contact’s portal
  - `payment_methods` AccountingContactPaymentMethod[]
    - `id` string
    - `type` 'ACH' | 'ALIPAY' | 'CARD' | 'GIROPAY' | 'IDEAL' | 'OTHER' | 'PAYPAL' | 'WIRE' | 'CHECK', required
    - `name` string
    - `default` boolean
  - `company_name` string
  - `identification` string: contact account numbers such as registration, A membership or identification reference to help to identify and search customers
  - `associated_contacts` AccountingAssociatedContact[]
    - `id` string
    - `name` string
    - `emails` AccountingEmail[]
      - `email` string
      - `type` 'WORK' | 'HOME' | 'OTHER'
  - `organization_id` string
  - `payment_terms` 'ON_RECEIPT' | 'NET_7' | 'NET_10' | 'NET_15' | 'NET_20' | 'NET_25' | 'NET_30' | 'NET_45' | 'NET_60' | 'NET_90' | 'OTHER'
  - `paymentterm_id` string
  - `balance_amount` number: Outstanding AR/AP balance for this contact
  - `website` string
  - `notes` string
  - `metadata` AccountingMetadata[]
    - `id` string
    - `slug` string
    - `value` unknown
    - `namespace` string
    - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
    - `extra_data` unknown
  - `raw` unknown

---

[API](https://skmtc.dev/unified/apis/unified-to-api-2.md) · [All operations](https://skmtc.dev/unified/apis/unified-to-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/unified/apis/unified-to-api-2/revisions/7a38bdd7f089?raw)