Contacts serve as a common, shared address book that's used across a company by many people for a variety of purposes. Contacts hold all the information needed to contact an individual or business, including name, email address, phone number, mailing address, and more.
Contacts are almost always used with other Sage Intacct objects, such as vendors, customers, or locations. For example, you specify a contact in Order Entry and Purchasing transactions to set a ship-to, bill-to, pay-to, or return-to addresses, and to determine tax on transactions.
Returns up to 100 contacts from the collection with a key, ID, and link for each contact. This operation is mostly for use in testing; use the query service to find contacts that meet certain criteria and specify the properties that are returned.
OK
Bad Request
{- "ia::result": [
- {
- "key": "265",
- "id": "Larry Spencer",
- "href": "/objects/company-config/contact/265"
}, - {
- "key": "263",
- "id": "John Doe",
- "href": "/objects/company-config/contact/263"
}, - {
- "key": "264",
- "id": "Alfred Mike",
- "href": "/objects/company-config/contact/264"
}
], - "ia::meta": {
- "totalCount": 3,
- "start": 1,
- "pageSize": 100,
- "next": null,
- "previous": null
}
}
Creates a new contact. The contact's entity
fields will be set to the entity that the OAuth access token is associated with when the contact is created.
Contact object to create
id required | string Unique identifier for the contact. Example: "rkincaid" | ||||||||||||||||
printAs required | string The contact's name as it will appear on bills, invoices, AR statements, advances, adjustments, checks, expense reports, expense reimbursements, and 1099s. Example: "Reuben Kincaid" | ||||||||||||||||
lastName | string or null Last name. Example: "Kincaid" | ||||||||||||||||
firstName | string or null First name. Example: "Reuben" | ||||||||||||||||
middleName | string or null Middle name or initial. Example: "X" | ||||||||||||||||
prefix | string or null Prefix, such as Mr., Mrs., or Ms. Example: "Mr." | ||||||||||||||||
email1 | |||||||||||||||||
email2 | |||||||||||||||||
phone1 | string or null Primary phone number. Example: "4151231234" | ||||||||||||||||
phone2 | string or null Secondary phone number. Example: "4158661823" | ||||||||||||||||
mobile | string or null Mobile phone number. Example: "4159879876" | ||||||||||||||||
pager | string or null Pager number. Example: "4151112222" | ||||||||||||||||
fax | string or null Fax number. Example: "4152221111" | ||||||||||||||||
URL1 | string or null Web page address for this contact. Example: "https://mycompany.com" | ||||||||||||||||
URL2 | string or null Secondary web page address. Example: "https://whitehouse.gov" | ||||||||||||||||
companyName | string or null Name of the company associated with this contact. Example: "AlcoSoft Inc" | ||||||||||||||||
showInContactList | boolean Default: true Set to Example: true | ||||||||||||||||
discount | string or null Default discount percentage to be applied to order entry transactions involving this contact. Example: "33" | ||||||||||||||||
status | string Default: "active" Object status. Active objects are fully functional. Inactive objects are essentially hidden and cannot be used or referenced. Example: "active" | ||||||||||||||||
object The mailing address of the contact. | |||||||||||||||||
| |||||||||||||||||
object Default price list used in order entry when this contact places orders. Read the notes in the Help Center for requirements and additional information. | |||||||||||||||||
| |||||||||||||||||
object Price schedule used in order entry when this contact places orders. | |||||||||||||||||
| |||||||||||||||||
object Tax settings needed for Intacct to calculate taxes on transactions for this contact. | |||||||||||||||||
|
Created
Bad Request
{- "id": "AMoore",
- "prefix": "Mr",
- "firstName": "Andy",
- "lastName": "Moore",
- "middleName": "Robert",
- "printAs": "Andy Moore",
- "companyName": "Sage",
- "phone1": "9134598676",
- "mobile": "9133132299",
- "fax": "9134598677",
- "mailingAddress": {
- "addressLine1": "744 Edgewater Blvd",
- "city": "Kansas City",
- "state": "KS",
- "postCode": "66104",
- "isoCountryCode": "us"
}, - "tax": {
- "isTaxable": true,
- "taxId": "123-12-1234",
- "group": {
- "id": "New York"
}
}, - "status": "active"
}
{- "ia::result": {
- "key": "312",
- "id": "AMoore",
- "href": "/objects/company-config/contact/312"
}, - "ia::meta": {
- "totalCount": 1,
- "totalSuccess": 1,
- "totalError": 0
}
}
Returns detailed information for a specified contact.
key required | string System-assigned key for a contact. Example: 65 |
OK
Bad Request
{- "ia::result": {
- "key": "1257",
- "id": "AMoore",
- "companyName": "Sage",
- "prefix": "Mr",
- "firstName": "Andy",
- "lastName": "Moore",
- "middleName": "Robert",
- "printAs": "Andy Moore",
- "tax": {
- "isTaxable": true,
- "group": {
- "id": "New York",
- "key": "6",
- "href": "/objects/company-config/contact-tax-group/6"
}, - "taxId": "123-12-1234"
}, - "phone1": "9134598676",
- "phone2": null,
- "mobile": "9133132299",
- "pager": null,
- "fax": "9134598677",
- "email2": null,
- "URL2": null,
- "showInContactList": true,
- "mailingAddress": {
- "addressLine1": "744 Edgewater Blvd",
- "addressLine2": null,
- "addressLine3": null,
- "city": "Kansas City",
- "country": "United States",
- "isoCountryCode": "us",
- "postCode": "66104",
- "state": "KS"
}, - "status": "active",
- "priceSchedule": {
- "id": null,
- "key": null
}, - "discount": null,
- "priceList": {
- "id": null,
- "key": null
}, - "entity": {
- "key": "54",
- "id": "Western Region",
- "name": "Western Region",
- "href": "/objects/company-config/entity/54"
}, - "href": "/objects/company-config/contact/1257"
}, - "ia::meta": {
- "totalCount": 1,
- "totalSuccess": 1,
- "totalError": 0
}
}
Updates an existing contact by setting field values. Any fields not provided remain unchanged.
key required | string System-assigned key for a contact. Example: 65 |
lastName | string or null Last name. Example: "Kincaid" | ||||||||||||||||
firstName | string or null First name. Example: "Reuben" | ||||||||||||||||
middleName | string or null Middle name or initial. Example: "X" | ||||||||||||||||
prefix | string or null Prefix, such as Mr., Mrs., or Ms. Example: "Mr." | ||||||||||||||||
email1 | |||||||||||||||||
email2 | |||||||||||||||||
phone1 | string or null Primary phone number. Example: "4151231234" | ||||||||||||||||
phone2 | string or null Secondary phone number. Example: "4158661823" | ||||||||||||||||
mobile | string or null Mobile phone number. Example: "4159879876" | ||||||||||||||||
pager | string or null Pager number. Example: "4151112222" | ||||||||||||||||
fax | string or null Fax number. Example: "4152221111" | ||||||||||||||||
URL1 | string or null Web page address for this contact. Example: "https://mycompany.com" | ||||||||||||||||
URL2 | string or null Secondary web page address. Example: "https://whitehouse.gov" | ||||||||||||||||
companyName | string or null Name of the company associated with this contact. Example: "AlcoSoft Inc" | ||||||||||||||||
printAs | string The contact's name as it will appear on bills, invoices, AR statements, advances, adjustments, checks, expense reports, expense reimbursements, and 1099s. Example: "Reuben Kincaid" | ||||||||||||||||
showInContactList | boolean Default: true Set to Example: true | ||||||||||||||||
discount | string or null Default discount percentage to be applied to order entry transactions involving this contact. Example: "33" | ||||||||||||||||
status | string Default: "active" Object status. Active objects are fully functional. Inactive objects are essentially hidden and cannot be used or referenced. Example: "active" | ||||||||||||||||
object The mailing address of the contact. | |||||||||||||||||
| |||||||||||||||||
object Default price list used in order entry when this contact places orders. Read the notes in the Help Center for requirements and additional information. | |||||||||||||||||
| |||||||||||||||||
object Price schedule used in order entry when this contact places orders. | |||||||||||||||||
| |||||||||||||||||
object Tax settings needed for Intacct to calculate taxes on transactions for this contact. | |||||||||||||||||
|
OK
Bad Request
{- "priceList": {
- "id": "Best customer pricing"
}, - "tax": {
- "isTaxable": false
}
}
{- "ia::result": {
- "key": "312",
- "id": "JohnD",
- "href": "/objects/company-config/contact/312"
}, - "ia::meta": {
- "totalCount": 1
}
}
Deletes a contact. You can delete a contact if it is not being used or referenced. Deleted contacts cannot be recovered.
key required | string System-assigned key for a contact. Example: 65 |
No Content
Bad Request
{- "ia::result": {
- "ia::error": {
- "code": "invalidRequest",
- "message": "A POST request requires a payload",
- "errorId": "REST-1028",
- "additionalInfo": {
- "messageId": "IA.REQUEST_REQUIRES_A_PAYLOAD",
- "placeholders": {
- "OPERATION": "POST"
}, - "propertySet": { }
}, - "supportId": "Kxi78%7EZuyXBDEGVHD2UmO1phYXDQAAAAo"
}
}, - "ia::meta": {
- "totalCount": 1,
- "totalSuccess": 0,
- "totalError": 1
}
}