POST v1/Contacts

Create a list of Contacts.

Request Information

URI Parameters

None.

Body Parameters

Collection of Contact
NameDescriptionTypeAdditional information

Type

Contact Type: Customer, Supplier

ContactType

Required

SalesPersonId

The User Id

integer

None.

AccountNumber

Account Number

string

Max length: 10

BillingId

Parent company member id

integer

None.

BillingCompany

Billing Company

string

Max length: 50

AccountsFirstName

Accounts contact first name

string

Max length: 50

AccountsLastName

Accounts contact last name

string

Max length: 50

BillingEmail

Billing Email

string

Max length: 50

AccountsPhone

Accounts contact phone

string

Max length: 50

BillingCostCenter

Alternative GL account of a Parent company if exists

string

None.

CostCenter

Alternative GL account

string

None.

PriceColumn

A price column name. Query ProductOptions to get a list of valid price column names.

string

None.

PercentageOff

Percentage Off Price Tier. Price discount on top of PriceColumn.

decimal number

Range: inclusive between 0 and 100

PaymentTerms

Payment terms

string

None.

TaxStatus

Tax Status

string

None.

TaxNumber

Taxt Number

string

None.

CreditLimit

Credit Limit

decimal number

None.

BalanceOwing

Balance Owing (read-only)

decimal number

None.

OnHold

Hold Status

boolean

None.

Group

Group

string

None.

SubGroup

Subgroup

string

None.

Stages

Stages

string

None.

AccountingIntegrationId

Accounting Integration Ids for Xero, QuickBooks Online and QuickBooks Desktop (readonly)

AccountingIntegrationId

None.

Id

The unique Cin7 Id.

integer

None.

CreatedDate

Created Date

date

None.

ModifiedDate

Modified Date

date

None.

IsActive

Is Active

boolean

None.

Company

Company

string

Max length: 250

FirstName

First Name

string

Max length: 250

LastName

Last Name

string

Max length: 250

JobTitle

Job Title

string

Max length: 250

Email

A unique email address

string

None.

Website

Website

string

Max length: 50

Phone

Phone

string

Max length: 50

Fax

Fax

string

Max length: 50

Mobile

Mobile

string

Max length: 50

Address1

Address 1

string

Max length: 50

Address2

Address 2

string

Max length: 50

City

City

string

Max length: 50

State

State

string

Max length: 50

PostCode

Post Code

string

Max length: 50

Country

Country

string

Max length: 50

PostalAddress1

Billing/Postal Address 1

string

Max length: 50

PostalAddress2

Billing/Postal Address 2

string

Max length: 50

PostalCity

Billing/Postal City

string

Max length: 50

PostalPostCode

Billing/Postal Post Code

string

Max length: 50

PostalState

Billing/Postal State

string

Max length: 50

PostalCountry

Billing/Postal Country

string

Max length: 50

Notes

Notes

string

Max length: 250

IntegrationRef

Integration reference.

string

None.

CustomFields

Custom fields.

Dictionary of string [key] and Object [value]

None.

SecondaryContacts

Secondary Contacts

Collection of SubContact

None.

Request Formats

application/json, text/json

Sample:
[
  {
    "id": 1,
    "createdDate": "2024-11-16T13:41:56.1638179Z",
    "modifiedDate": "2024-11-16T13:41:56.1638179Z",
    "isActive": true,
    "company": "Acme Corporation",
    "firstName": "Jane",
    "lastName": "Doe",
    "jobTitle": "Managing Director",
    "email": "jane@acmecorpation.com",
    "website": "www.acmecorpation.com",
    "phone": "(000) 123-4567",
    "fax": "(000) 123-4567",
    "mobile": "(000) 123-4567",
    "address1": "1600 Amphitheatre Pkwy",
    "address2": null,
    "city": "Mountain View",
    "state": "CA",
    "postCode": "94043",
    "country": "USA",
    "postalAddress1": "Postal Address Line 1",
    "postalAddress2": "Postal Address Line 2",
    "postalCity": "Postal City",
    "postalPostCode": "Postal Code",
    "postalState": "State",
    "postalCountry": "Country",
    "notes": "Sample client contact.",
    "integrationRef": "MY-INTEGRATION-REF",
    "customFields": null,
    "secondaryContacts": [
      {
        "id": 1,
        "company": "Bob's Company",
        "firstName": "Bob",
        "lastName": "Joans",
        "jobTitle": "Freelance Consultant",
        "email": "bob@acmecorpation.com",
        "mobile": null,
        "phone": null
      },
      {
        "id": 2,
        "company": null,
        "firstName": "Lara",
        "lastName": "Croft",
        "jobTitle": "Accountant",
        "email": "lara@acmecorpation.com",
        "mobile": null,
        "phone": null
      }
    ],
    "type": "Customer",
    "salesPersonId": 0,
    "accountNumber": null,
    "billingId": 0,
    "billingCompany": "Billing Company Name",
    "accountsFirstName": "Account Contact First Name",
    "accountsLastName": "Account Contact Last Name",
    "billingEmail": "",
    "accountsPhone": "(000) 123-4567",
    "billingCostCenter": null,
    "costCenter": null,
    "priceColumn": "Retail",
    "percentageOff": null,
    "paymentTerms": null,
    "taxStatus": null,
    "taxNumber": null,
    "creditLimit": 0.0,
    "balanceOwing": 0.0,
    "onHold": null,
    "group": null,
    "subGroup": null,
    "stages": null,
    "accountingIntegrationId": {
      "xero": "12345",
      "quickBooksOnline": "12345",
      "quickBooksDesktop": null
    }
  },
  {
    "id": 1,
    "createdDate": "2024-11-16T13:41:56.1638179Z",
    "modifiedDate": "2024-11-16T13:41:56.1638179Z",
    "isActive": true,
    "company": "Supplier Company",
    "firstName": "Jack",
    "lastName": "",
    "jobTitle": "Owner",
    "email": "jack@suppliercompany.com",
    "website": "www.suppliercompany.com",
    "phone": "(000) 123-4567",
    "fax": "(000) 123-4567",
    "mobile": "(000) 123-4567",
    "address1": "Address1",
    "address2": "Address2",
    "city": "City",
    "state": "State",
    "postCode": "94043",
    "country": "USA",
    "postalAddress1": "Postal Address Line 1",
    "postalAddress2": "Postal Address Line 2",
    "postalCity": "Postal City",
    "postalPostCode": "Postal Code",
    "postalState": "State",
    "postalCountry": "USA",
    "notes": "Sample supplier contact.",
    "integrationRef": "MY-INTEGRATION-REF",
    "customFields": null,
    "secondaryContacts": null,
    "type": "Supplier",
    "salesPersonId": 0,
    "accountNumber": null,
    "billingId": 0,
    "billingCompany": "Billing Company",
    "accountsFirstName": "Account Contact First Name",
    "accountsLastName": "Account Contact Last Name",
    "billingEmail": "",
    "accountsPhone": "(000) 123-4567",
    "billingCostCenter": null,
    "costCenter": null,
    "priceColumn": "Retail",
    "percentageOff": null,
    "paymentTerms": null,
    "taxStatus": null,
    "taxNumber": null,
    "creditLimit": 0.0,
    "balanceOwing": 0.0,
    "onHold": null,
    "group": null,
    "subGroup": null,
    "stages": null,
    "accountingIntegrationId": {
      "xero": "12345",
      "quickBooksOnline": "12345",
      "quickBooksDesktop": null
    }
  }
]

Response Information

Resource Description

Collection of BatchResultItem
NameDescriptionTypeAdditional information

Index

​The index at which the record was positioned in an insert or update.

integer

None.

Success

​True if the record was successfully inserted or updated.

boolean

None.

Id

The record Id.

integer

None.

Code

The record code.

string

None.

Errors

A list of errors if the insert or update fails.

Collection of string

None.

Response Formats

application/json, text/json

Sample:
[
  {
    "index": 0,
    "success": true,
    "id": 1,
    "code": "SALE4-28",
    "errors": []
  },
  {
    "index": 1,
    "success": true,
    "id": 2,
    "code": "SALE5-29",
    "errors": []
  }
]