FAfactorialhr
Finance > Contact

Updates a Contact

Changed on

Updates a Contact

put/api/2026-10-01/resources/finance/contacts/{id}

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/finance/contacts/{id}
  • Auth
    API key in header x-api-key

Path parameters

idstring required

ID of the Contact to update.

Request body

idstring required

ID of the Contact to update.

tax_idstring

Tax identification number assigned to the Contact.

legal_namestring

The official or legal name of the Contact.

namestring

The commercial name of the Contact.

websitestring

The website of the Contact.

emailstring

The email of the Contact.

phone_numberstring

The phone number of the Contact.

Example request

{
  "id": "123",
  "tax_id": "X1234567",
  "legal_name": "Google engineering vendor",
  "name": "Google",
  "address": {
    "city": "East Ariana",
    "country_code": "SC",
    "line1": "93402 Spencer Points",
    "line2": "Apt. 555",
    "postal_code": "61471",
    "state": "Oklahoma"
  },
  "website": "https://www.example.com",
  "email": "contact@example.com",
  "phone_number": "+1234567890"
}

Response

OK

idstring required

Unique identifier for the Contact.

namestring required

The commercial name of the Contact.

legal_namestring

The official or legal name of the Contact.

tax_idstring

Tax identification number assigned to the Contact.

external_idstring

The external id of the contact.

updated_atstring required

Timestamp when the Contact was last updated.

ibanstring

International Bank Account Number if provided.

bank_codestring

Bank or branch code for the Contact if relevant.

preferred_payment_method'card' | 'banktransfer'

Preferred payment method for the Contact (e.g. wire_transfer, paypal).

websitestring

The website of the Contact.

emailstring

The email of the Contact.

phone_numberstring

The phone number of the Contact.

Example response

{
  "id": "123",
  "name": "Google",
  "legal_name": "Google engineering vendor",
  "tax_id": "X1234567",
  "address": {
    "city": "East Ariana",
    "country_code": "SC",
    "line1": "93402 Spencer Points",
    "line2": "Apt. 555",
    "postal_code": "61471",
    "state": "Oklahoma"
  },
  "external_id": "EXT-CONTACT-001",
  "updated_at": "2025-01-01T00:00:00.000Z",
  "iban": "GB25ZFXH46063029945396",
  "bank_code": "BABCESMM",
  "preferred_payment_method": "banktransfer",
  "website": "https://www.example.com",
  "email": "contact@example.com",
  "phone_number": "+1234567890"
}

Changes