Vendors

Create a vendor

Creates a vendor in your organization's directory. Only name is required; type defaults to other. Creating a vendor here does not check for duplicates — filter by custom_id or name first if your integration should reuse an existing vendor.

post/vendors

Request

  • Base URL: https://api.rabbet.com/v1
  • URL: https://api.rabbet.com/v1/vendors
  • Auth: OAuth 2 (client credentials, token URL https://api.rabbet.com/oauth/token, scopes: write)

Headers

Idempotency-Keystring

Optional client-supplied key making this request idempotent. Reuse the same value (for the same request) to safely retry.

Request body

namestring required
type'accountant' | 'architect' | 'borrower' | 'broker' | 'civil_engineer' | 'client' | 'construction_services' | 'consultant' | 'contractor' | 'developer' | 'development_manager' | 'engineer' | 'equity_partner' | 'guarantor' | 'inspector' | 'lawyer' | 'lender' | 'municipality' | 'other' | 'property_manager' | 'site_contact' | 'subcontractor' | 'title_company' | 'vendor'

The kind of company the vendor is.

custom_idstring

Your identifier for the vendor.

email_addressesstring[]
phone_numbersstring[]

Stored digits-only; formatting characters are stripped.

street_addressstring
citystring
state'aa' | 'ab' | 'ae' | 'ak' | 'al' | 'ap' | 'ar' | 'as' | 'az' | 'bc' | 'ca' | 'co' | 'ct' | 'dc' | 'de' | 'fl' | 'fm' | 'ga' | 'gu' | 'hi' | 'ia' | 'id' | 'il' | 'in' | 'ks' | 'ky' | 'la' | 'ma' | 'mb' | 'md' | 'me' | 'mh' | 'mi' | 'mn' | 'mo' | 'mp' | 'ms' | 'mt' | 'nb' | 'nc' | 'nd' | 'ne' | 'nh' | 'nj' | 'nl' | 'nm' | 'ns' | 'nt' | 'nu' | 'nv' | 'ny' | 'oh' | 'ok' | 'on' | 'or' | 'pa' | 'pe' | 'pr' | 'pw' | 'qc' | 'ri' | 'sc' | 'sd' | 'sk' | 'tn' | 'tx' | 'ut' | 'va' | 'vi' | 'vt' | 'wa' | 'wi' | 'wv' | 'wy' | 'yt'

Two-letter lowercase state, territory, or Canadian province code.

zipstring
is_1099boolean

Example request

{
  "name": "ACME Construction LLC",
  "type": "contractor",
  "custom_id": "V-00042",
  "state": "tx"
}

Response

The created vendor.

Example response

{
  "data": {
    "id": "b7b36587-1c9f-4e2c-a5b0-6f0a4b2f9e11",
    "name": "ACME Construction LLC",
    "type": "contractor",
    "custom_id": "V-00042",
    "email_addresses": [
      "ap@acmeconstruction.com"
    ],
    "phone_numbers": [
      "512-555-0142"
    ],
    "street_address": "100 Congress Ave",
    "city": "Austin",
    "state": "tx",
    "zip": "78701"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.