# NewOrgVendorInput

input type

Create-input for an OrgVendor. The tenant (org group) is derived SERVER-SIDE from the principal; organizationId (the parent org) and vendorId are tenant-scoped server-side and must be active (STRICT), as are the shipTo/billTo/returnsTo pointers when supplied. Every commercial field is optional (the enablement stays creatable thin); orderMinimum/freeFreightThreshold require purchasingCurrency in the SAME payload with a MATCHING currency; requireCatalogItem is stamped FALSE when omitted.

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `caption` | [String](/types/#scalars) | no | Optional: when omitted the per-type default applies — the merchant code when given, else 'Org Vendor'; when supplied it must be non-blank. |
| `organizationId` | [ID](/types/#scalars) `ID!` | yes | The parent Organization id — rides the header. |
| `vendorId` | [ID](/types/#scalars) `ID!` | yes | The group Vendor this enablement names — immutable after birth. |
| `accountNumber` | [String](/types/#scalars) | no | No further notes. |
| `terms` | [String](/types/#scalars) | no | No further notes. |
| `purchasingCurrency` | [String](/types/#scalars) | no | No further notes. |
| `paymentTerms` | [String](/types/#scalars) | no | The canned payment-terms token (net-30 · 2-10-net-30 · cod · prepaid). |
| `incotermCode` | [String](/types/#scalars) | no | The canned Incoterms-2020 code (EXW · FCA · CPT · CIP · DAP · DPU · DDP · FAS · FOB · CFR · CIF). |
| `leadTimeDays` | [Int](/types/#scalars) | no | No further notes. |
| `defaultShipToLogicalFacilityId` | [ID](/types/#scalars) | no | No further notes. |
| `billToContactId` | [ID](/types/#scalars) | no | No further notes. |
| `returnsToContactId` | [ID](/types/#scalars) | no | No further notes. |
| `orderMinimum` | [MoneyEntryInput](/types/MoneyEntryInput/) | no | Requires purchasingCurrency in the same payload, with a matching currency. |
| `freeFreightThreshold` | [MoneyEntryInput](/types/MoneyEntryInput/) | no | Requires purchasingCurrency in the same payload, with a matching currency. |
| `requireCatalogItem` | [Boolean](/types/#scalars) | no | Defaulted FALSE when omitted. |
| `code` | [String](/types/#scalars) | no | No further notes. |

## Used by

- [createOrgVendor](/reference/org-vendor/createOrgVendor/)
