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,
  "error_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"
    }
  ],
  "errors": []
}

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

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.

Allows for the creation or updating of multiple vendors in a single request. Maximum 100 vendors per request. **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

Idempotency-KeystringOptionalformat: "^[A-Za-z0-9._\-+=/]{1,128}$"1-128 characters

Client-generated unique key (UUID/ULID recommended). JSON requests: the first 2xx response is cached for 24h and replayed on a same-key retry with a matching body; a different body returns 422. Non-JSON requests (e.g. file uploads): the key is single-use — any same-key retry returns 422 regardless of body. See Idempotency for full details.

Request

ottimate_company_idintegerRequired

vendorslist of objectsRequired

Response

Successfully created or updated

versionstringOptional

success_countintegerOptional

created_countintegerOptional

updated_countintegerOptional

error_countintegerOptional

createdlist of objectsOptional

updatedlist of objectsOptional

errorslist of objectsOptional

Errors

400

Bad Request Error

403

Forbidden Error