POST /vendors.json

POST /vendors.json
application/json

Body Required

  • accountsEmail string | null

    Accounts email

  • automaticallyBackorder string | null Required

    Automatically backorder

    Values are company_default, backorder, or ignore. Default value is company_default.

  • companyCode string | null

    Company code

    Maximum length is 30.

  • currencyId integer(int32) | null

    Cost prices will be converted at this currency on purchase orders. You can either use fixed or automatic exchange rates. Currencies can be added under Setup > Currencies then assigned here.

  • deliveryDays integer(int32) | null Required

    Delivery days

    Default value is 0.

  • dropshipProcessing string | null Required

    Dropship processing

    Values are direct or dropship_provider. Default value is dropship_provider.

  • email string | null

    Email

  • fax string | null

    Fax

    Maximum length is 30.

  • firstName string | null

    First name

  • fulfillmentPolicy string | null Required

    Fulfillment policy

    Values are manual, dropship, fulfill, company_default, or blended. Default value is company_default.

  • lastName string | null

    Last name

  • name string Required

    Name

  • noInventoryPolicy string | null Required

    No inventory policy

    Values are manual, dropship, or replenish. Default value is manual.

  • notes string | null

    Notes

  • orderEmail string | null

    Order email

  • paymentDays integer(int32) | null Required

    Payment days

    Default value is 0.

  • phone string | null

    Phone

    Maximum length is 30.

  • returnsEmail string | null

    Returns email

  • source string | null Required

    Source

    Values are channel, manual, dropshipProvider, or invenotryFeed. Default value is channel.

  • Specify dropship providers

    Default value is true.

  • taxNumber string | null

    Tax number

    Maximum length is 30.

  • warehouseId integer(int32) | null

    Warehouse

  • warehouseRouting string | null Required

    Warehouse routing

    Values are select or routed. Default value is select.

  • xeroId string | null

    Xero

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • accountsEmail string | null

      Accounts email

    • automaticallyBackorder string | null Required

      Automatically backorder

      Values are company_default, backorder, or ignore. Default value is company_default.

    • companyCode string | null

      Company code

      Maximum length is 30.

    • createdAt string(date-time)

      Created at

    • currencyId integer(int32) | null

      Cost prices will be converted at this currency on purchase orders. You can either use fixed or automatic exchange rates. Currencies can be added under Setup > Currencies then assigned here.

    • deliveryDays integer(int32) | null Required

      Delivery days

      Default value is 0.

    • dropshipProcessing string | null Required

      Dropship processing

      Values are direct or dropship_provider. Default value is dropship_provider.

    • email string | null

      Email

    • fax string | null

      Fax

      Maximum length is 30.

    • firstName string | null

      First name

    • fulfillmentPolicy string | null Required

      Fulfillment policy

      Values are manual, dropship, fulfill, company_default, or blended. Default value is company_default.

    • id integer(int32)

      Id

    • lastName string | null

      Last name

    • name string Required

      Name

    • noInventoryPolicy string | null Required

      No inventory policy

      Values are manual, dropship, or replenish. Default value is manual.

    • notes string | null

      Notes

    • orderEmail string | null

      Order email

    • paymentDays integer(int32) | null Required

      Payment days

      Default value is 0.

    • phone string | null

      Phone

      Maximum length is 30.

    • returnsEmail string | null

      Returns email

    • source string | null Required

      Source

      Values are channel, manual, dropshipProvider, or invenotryFeed. Default value is channel.

    • Specify dropship providers

      Default value is true.

    • taxNumber string | null

      Tax number

      Maximum length is 30.

    • updatedAt string(date-time)

      Updated at

    • warehouseId integer(int32) | null

      Warehouse

    • warehouseRouting string | null Required

      Warehouse routing

      Values are select or routed. Default value is select.

    • xeroId string | null

      Xero

POST /vendors.json
curl \
 -X POST http://api.example.com/v1/vendors.json \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"accountsEmail":"string","automaticallyBackorder":"company_default","companyCode":"string","currencyId":42,"deliveryDays":0,"dropshipProcessing":"dropship_provider","email":"string","fax":"string","firstName":"string","fulfillmentPolicy":"company_default","lastName":"string","name":"string","noInventoryPolicy":"manual","notes":"string","orderEmail":"string","paymentDays":0,"phone":"string","returnsEmail":"string","source":"channel","specifyDropshipProviders":true,"taxNumber":"string","warehouseId":42,"warehouseRouting":"select","xeroId":"string"}'
Request example
{
  "accountsEmail": "string",
  "automaticallyBackorder": "company_default",
  "companyCode": "string",
  "currencyId": 42,
  "deliveryDays": 0,
  "dropshipProcessing": "dropship_provider",
  "email": "string",
  "fax": "string",
  "firstName": "string",
  "fulfillmentPolicy": "company_default",
  "lastName": "string",
  "name": "string",
  "noInventoryPolicy": "manual",
  "notes": "string",
  "orderEmail": "string",
  "paymentDays": 0,
  "phone": "string",
  "returnsEmail": "string",
  "source": "channel",
  "specifyDropshipProviders": true,
  "taxNumber": "string",
  "warehouseId": 42,
  "warehouseRouting": "select",
  "xeroId": "string"
}
Response examples (200)
{
  "accountsEmail": "string",
  "automaticallyBackorder": "company_default",
  "companyCode": "string",
  "createdAt": "2024-05-04T09:42:00+00:00",
  "currencyId": 42,
  "deliveryDays": 0,
  "dropshipProcessing": "dropship_provider",
  "email": "string",
  "fax": "string",
  "firstName": "string",
  "fulfillmentPolicy": "company_default",
  "id": 42,
  "lastName": "string",
  "name": "string",
  "noInventoryPolicy": "manual",
  "notes": "string",
  "orderEmail": "string",
  "paymentDays": 0,
  "phone": "string",
  "returnsEmail": "string",
  "source": "channel",
  "specifyDropshipProviders": true,
  "taxNumber": "string",
  "updatedAt": "2024-05-04T09:42:00+00:00",
  "warehouseId": 42,
  "warehouseRouting": "select",
  "xeroId": "string"
}