Create or update multiple accounting vendors | Ottimate Developer Documentation

curl -X POST https://api.ottimate.com/v1/vendors/bulk \
     -H "X-Api-Key: your-api-key-here" \
     -H "X-API-Version: 1.0.0" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "ottimate_company_id": 15196,
  "vendors": [
    {
      "erp_vendor_name": "Local Produce Co",
      "erp_vendor_id": "LPC-001",
      "email": "orders@localproduce.com",
      "phone": "+1-555-111-2222",
      "net_terms": "Net 15",
      "payment_method": "ach",
      "address_line_1": "100 Farm Road",
      "city": "Springfield",
      "state": "IL",
      "zipcode": "62701"
    },
    {
      "erp_vendor_name": "Premium Meats LLC",
      "erp_vendor_id": "PML-001",
      "email": "sales@premiummeats.com",
      "payment_method": "check"
    }
  ]
}'

{
  "version": "1.0.0",
  "success_count": 3,
  "created_count": 2,
  "updated_count": 1,
  "fail_count": 0,
  "created": [
    {
      "id": 169860251,
      "ottimate_company_id": 15196,
      "erp_vendor_id": "LPC-001",
      "erp_vendor_name": "Local Produce Co",
      "email": "orders@localproduce.com",
      "phone": "+1-555-111-2222",
      "net_terms": "Net 15",
      "payment_method": "ach",
      "address_line_1": "100 Farm Road",
      "address_line_2": null,
      "city": "Springfield",
      "state": "IL",
      "zipcode": "62701"
    },
    {
      "id": 169860252,
      "ottimate_company_id": 15196,
      "erp_vendor_id": "PML-001",
      "erp_vendor_name": "Premium Meats LLC",
      "email": "sales@premiummeats.com",
      "phone": null,
      "net_terms": null,
      "payment_method": "check",
      "address_line_1": null,
      "address_line_2": null,
      "city": null,
      "state": null,
      "zipcode": null
    }
  ],
  "updated": [
    {
      "id": 169860239,
      "ottimate_company_id": 15196,
      "erp_vendor_id": "SYS-001",
      "erp_vendor_name": "Sysco Foods Corp (Updated)",
      "email": "orders@sysco.com",
      "phone": "+1-555-999-8888",
      "net_terms": "Net 30",
      "payment_method": "wire_transfer",
      "address_line_1": "1 Sysco Way",
      "address_line_2": null,
      "city": "Houston",
      "state": "TX",
      "zipcode": "77077"
    }
  ],
  "failures": []
}

Allows for the creation or updating of multiple vendors in a single request. Maximum 100 vendors per request.

Vendors are saved one by one. If some fail, the others are still saved: the response lists the failed ones in failures and counts them in fail_count. If every vendor fails, the response is a 400 with code VEN4000, and message holds the same object with success_count 0 and the reasons in failures.

Deprecation notice: This synchronous endpoint is deprecated for high-volume use. Use POST /vendors/bulk-async instead — it avoids request timeouts on large batches and provides progress tracking via the batch polling API. This endpoint remains fully supported for existing integrations.

Authentication

AuthorizationBearer

OAuth2 authentication flows. Auth server URLs will vary by environment

Headers

Request

This endpoint expects an object.

ottimate_company_idintegerRequired

vendorslist of objectsRequired

Response

Successfully created or updated

versionstringOptional

success_countintegerOptional

created_countintegerOptional

updated_countintegerOptional

fail_countintegerOptional

(Beta — this field is available in sandbox and not yet in production.)

createdlist of objectsOptional

updatedlist of objectsOptional

failureslist of objectsOptional

(Beta — this field is available in sandbox and not yet in production.)

Errors

400

Bad Request Error

403

Forbidden Error

422

Unprocessable Entity Error