Contacts
Manage a tenant's contacts: the people and organisations it does business with, in one or more roles. Customers are invoiced by the tenant, suppliers invoice the tenant, and CIS subcontractors are suppliers paid under the Construction Industry Scheme. One contact, one code, whatever its roles; filter the list with role. A subcontractor carries its CIS identity (UTR, NI number, company number), invoice defaults and the current HMRC verification, and must be verified with HMRC before payments can be processed.
-
GET List ContactsLists all Contacts for the given tenant./tenants/{tenant}/contacts
-
POST Create ContactCreates a new Contact for the specified tenant./tenants/{tenant}/contacts
-
GET Get ContactGets a Contact for the specified tenant./tenants/{tenant}/contacts/{code}
-
PUT Update ContactUpdates a Contact for the specified tenant./tenants/{tenant}/contacts/{code}
-
DELETE Delete ContactDeletes a Contact for the specified tenant./tenants/{tenant}/contacts/{code}
-
POST Analyze ContactsValidates the import template CSV (multipart/form-data, field 'file'; the template is the one the app downloads, header names are matched loosely and .../tenants/{tenant}/contacts/import/analyze
-
POST Import ContactsImports the selected rows of the import template CSV (multipart/form-data: the file as 'file' and 'selections', a JSON array of { rowId } from the ana.../tenants/{tenant}/contacts/import