---
title: "Updates company contact information."
method: PUT
path: "/companies/{companyId}/contactinfo/{contactInfoId}"
tags: ["companies"]
---

# Updates company contact information.

`PUT /companies/{companyId}/contactinfo/{contactInfoId}`

## Request

- Base URL: `https://api.awork.com/api/v1`
- URL: `https://api.awork.com/api/v1/companies/{companyId}/contactinfo/{contactInfoId}`
- Auth: HTTP bearer

Updates the specified company contact information and refreshes the company's address data when needed. The contact information must belong to the specified company.

<Check title="Required Permissions" icon="key">The user must be an admin or have `company-master-data:write` permissions.</Check>

## Path parameters

- `companyId` string, uuid, required
- `contactInfoId` string, uuid, required

## Request body

- ContactInfoForm: The contact info are different types of contact information for a company
  - `label` string, nullable: The label of the contact info. Only necessary if type 'custom' is used.
  - `value` string, nullable: The value of the contact info.
  - `type` string, required: The type of the contact info. Possible values are: 'phone', 'email', 'address', 'url', 'custom'.
  - `subType` string, nullable: The subtype of the contact info. Required for all types except 'custom'. Possible values are: phone: [ 'central', 'other' ] email: [ 'central', 'invoice', 'other' ] address: [ 'central', 'invoice', 'other' ] url: [ 'primary', 'other' ]
  - `addressLine1` string, nullable: The first address line of the contact info.
  - `addressLine2` string, nullable: The second address line of the contact info.
  - `zipCode` string, nullable: The zipcode of the contact info.
  - `city` string, nullable: The city of the contact info.
  - `state` string, nullable: The state of the contact info.
  - `country` string, nullable: The 2 letter iso code of the country.
  - `isAddress` boolean: Flags whether this contact info is an address. If it's an address, the address fields are required.

## Response `200`

OK

- ContactInfoForCompanies: The contact info are different types of contact information for a company
  - `label` string, nullable: The label of the contact info. Only necessary if type 'custom' is used.
  - `value` string, nullable: The value of the contact info.
  - `type` string, required: The type of the contact info. Possible values are: 'phone', 'email', 'address', 'url', 'custom'.
  - `subType` string, nullable: The subtype of the contact info. Required for all types except 'custom'. Possible values are: phone: [ 'central', 'other' ] email: [ 'central', 'invoice', 'other' ] address: [ 'central', 'invoice', 'other' ] url: [ 'primary', 'other' ]
  - `addressLine1` string, nullable: The first address line of the contact info.
  - `addressLine2` string, nullable: The second address line of the contact info.
  - `zipCode` string, nullable: The zipcode of the contact info.
  - `city` string, nullable: The city of the contact info.
  - `state` string, nullable: The state of the contact info.
  - `country` string, nullable: The 2 letter iso code of the country.
  - `isAddress` boolean: Flags whether this contact info is an address. If it's an address, the address fields are required.
  - `id` string, uuid: The Id of the contact info.
  - `createdOn` string, date-time: The date this entity was created.
  - `createdBy` string, uuid: The id of the user who created this entity.
  - `updatedOn` string, date-time: The date this entity was last modified.
  - `updatedBy` string, uuid: The id of the user who last modified this entity.

## Other responses

- `400`: Bad Request
- `404`: Not Found

## Changes

- **2026-09-17** `1556e0487867`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `oauth2` was added to the API
- **2026-09-12** `8e46cf415581`: 1 info
  - api operation id `PutCompanyContactInfoByCompanyIdAndContactInfoId` removed and replaced with `companies_PutCompanyContactInfoByCompanyIdAndContactInfoId`
- **2026-08-21** `a13e7c704262`: 10 warning
  - the `addressLine1` request property's maxLength was set to `1000`
  - the `addressLine2` request property's maxLength was set to `100`
  - the `city` request property's maxLength was set to `100`
  - the `country` request property's maxLength was set to `100`
  - …6 more

[Operation history](https://skmtc.dev/awork-io/apis/api-v1-reference/changes/companies/:companyId/contactinfo/:contactInfoId/put.md)

---

[API](https://skmtc.dev/awork-io/apis/api-v1-reference.md) · [All operations](https://skmtc.dev/awork-io/apis/api-v1-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/awork-io/apis/api-v1-reference/revisions/81151fac7e79?raw)