Create a supplier

post

https://api.montavire.com/api/v1/suppliers

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Fields to create a supplier.

address

string

length between 0 and 500

city

string

length between 0 and 100

company_name

string

required

length between 0 and 255

Trading name of the supplier.

contact_email

string

required

length between 0 and 255

Primary contact email.

contact_name

string

length between 0 and 255

Primary contact name.

contact_phone

string

length between 0 and 50

Primary contact phone.

country

string

length between 0 and 100

ISO 3166 country.

currency

string

length between 0 and 3

ISO 4217 currency code; defaults to GBP when omitted.

eori_number

string

length between 0 and 50

EORI number for customs.

external_id

string

length between 0 and 120

Your system's identifier for this supplier; lets you reference it in later calls (e.g. purchase orders) without storing the Montavire id.

notes

string

length between 0 and 1000

payment_terms

int32

Payment terms in days.

postal_code

string

length between 0 and 20

rating

number

Supplier rating, 0 to 5.

state

string

length between 0 and 100

tax_id

string

length between 0 and 50

Tax / VAT identifier.

uk_importer

string

length between 0 and 255

Headers

Idempotency-Key

string

Optional client-generated key (recommended: a UUID) that makes a write safe to retry. Replaying the same key within the retention window returns the original response instead of creating a duplicate. Scoped per tenant.

Response

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

*/*

200OK