Create a Contact

Creates a new contact such as a customer or vendor in your accounting platform.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Supported Apps

AppApp IDRemarks
XeroxerocontactType is not honored by xero. It will map a contact to CUSTOMER or VENDOR based on activity (invoices/bills generated).
ZohobookszohobooktaxNumber key will have tax registration number with respect to country. For Indian customers it will be GST Number.
Microsoft Dynamics 365microsoft-dynamics-365
Sage IntacctsageIntacctid key needs to be passed in metaData for creating contact which is user defined unique Identifier for that Contact.
Quickbooksquickbooksname is mandatory field.
Freshbooksfreshbooks
NetsuitenetsuitePass companyId in metaData
Sage 200 Standardsage200

metaData.reference is a required field of type string (less than 9 chars).
If you want to specify country in the address object, specify country_code id as value for country, you can get the country_code ids by making a

passthrough

API call with path = /country_codes' and method = GET

Wave FinancialwavecontactType must be CUSTOMER. The app does not support APIs for Vendors.
Oracle Financialsoracle-financials
  • Supported fields: contactType, name, contactPersonFirstName, contactPersonLastName, email, phoneNumber, taxNumber, addresses, metaData.taxOrganizationType, metaData.businessRelationship, and metaData.taxRegistrationCountryCode.
  • Required fields: contactType, name, metaData.taxOrganizationType, metaData.businessRelationship.
  • taxOrganizationType possible values: Corporation, Foreign Corporation, and Individual.
  • businessRelationship possible values: Prospective and Spend Authorized.
  • Valid values for taxRegistrationCountryCode and addresses.country: alpha2 country code.
Odoo Accounting Onlineodooname, contactType, email, phoneNumber, addresses[0] are honored fields.
addresses[0].state, addresses[0].country expects state_id and country_id which can be obtained by making a passthrough request.
Body Params
string
required

Name of contact (It could be individual or buisness)

string
enum
required
Allowed:
string
string
string
string
string
addresses
array of objects
addresses
string

JSON-formatted string containing set of key-value attributes to provide additional data

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json