Skip to navigation
Common ModelsContacts

The Contact object

A Contact is an individual or business entity to which products and services are sold to or purchased from. The Contact model contains both Customers, in which products and services are sold to, and Vendors (or Suppliers), in which products and services are purchased from.

  • A Contact is a Vendor/Supplier if the is_supplier property is true.
  • A Contact is a customer if the is_customer property is true.
idstringOptionalRead-onlyformat: "uuid"
remote_idstring or nullOptional

The third-party API ID of the matching object.

created_atdatetimeOptionalRead-only
The datetime that this object was created by Merge.
modified_atdatetimeOptionalRead-only
The datetime that this object was modified by Merge.
namestring or nullOptional
The contact's name.
is_supplierboolean or nullOptional
Whether the contact is a supplier.
is_customerboolean or nullOptional
Whether the contact is a customer.
email_addressstring or nullOptional
The contact's email address.
tax_numberstring or nullOptional
The contact's tax number.
statusenum or nullOptional

The contact's status. This field is an open enum: Merge can return a value outside this list when an integration provides one it does not map. Pass show_enum_origins=status to receive the integration's own value instead.

Allowed values:
currencystring or nullOptional
The currency the contact's transactions are in.
remote_updated_atdatetime or nullOptional
When the third party's contact was updated.
companystring or nullOptionalformat: "uuid"
The company the contact belongs to.
addresseslist of objectsOptional

Address object IDs for the given Contacts object.

phone_numberslist of objectsOptional

AccountingPhoneNumber object for the given Contacts object.

contact_urlstring or nullOptionalformat: "uri"<=2000 characters
The 3rd party URL of the contact.
remote_was_deletedbooleanOptionalRead-only

Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. Learn more.

field_mappingsobject or nullOptionalRead-only
remote_datalist of objects or nullOptionalRead-only
remote_fieldslist of objectsOptionalRead-only