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_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",
      "city": "Springfield",
      "state": "IL",
      "zipcode": "62701"
    },
    {
      "erp_vendor_id": "PML-001",
      "erp_vendor_name": "Premium Meats LLC",
      "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.

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 objectsOptional

Response

Successfully created or updated

versionstring

success_countinteger

created_countinteger

updated_countinteger

error_countinteger

createdlist of objects

updatedlist of objects

errorslist of objects

Errors

400

Bad Request Error