Sign in
latestOpenAPI 3.0.02026-08-10233809957.8 KB

5cdfae3fa1fa

Vendors

PUT an update to a vendor for a business.

put/vendors/{id}

Path parameters

idstring required

Request body

Example request

{
  "connection": {
    "businessName": "Railz",
    "serviceName": "quickbooks"
  },
  "data": {
    "contactFirstName": "Jane",
    "contactLastName": "Smith",
    "emailAddress": "email@acme.com",
    "phone": "8889990000",
    "website": "www.acme.com",
    "vendorName": "ACME Inc.",
    "addresses": [
      {
        "type": "billing",
        "line1": "1234 Park Street",
        "line2": "Suite 1000",
        "city": "Toronto",
        "region": "ON",
        "country": "CAN",
        "postalCode": "A0B1C2"
      }
    ],
    "defaultCurrency": "CAD",
    "subsidiaryRefs": [
      "1",
      "3"
    ]
  }
}

Response

pushCommunicationIdstring required
requestedOnstring date-time required
status'success' | 'failed' | 'pending' required
businessNamestring required
serviceName'freshbooks' | 'quickbooks' | 'quickbooksDesktop' | 'xero' | 'oracleNetsuite' | 'sageBusinessCloud' | 'sageIntacct' | 'dynamicsBusinessCentral' | 'dynamics365Finance' | 'wave' | 'myob' | 'zohoBooks' | 'byod' required

Example response

{
  "pushCommunicationId": "60473b57f0cdd1683ca71f60",
  "requestedOn": "2021-03-09T08:15:22.035Z",
  "status": "pending",
  "businessName": "Railz",
  "serviceName": "quickbooks",
  "data": {
    "contactFirstName": "Jane",
    "contactLastName": "Smith",
    "emailAddress": "email@acme.com",
    "phone": "8889990000",
    "website": "www.acme.com",
    "vendorName": "ACME Inc.",
    "addresses": [
      {
        "type": "billing",
        "line1": "1234 Park Street",
        "line2": "Suite 1000",
        "city": "Toronto",
        "region": "ON",
        "country": "CAN",
        "postalCode": "A0B1C2"
      }
    ],
    "defaultCurrency": "CAD",
    "subsidiaryRefs": [
      "1",
      "3"
    ]
  }
}