🔒 Create supplier V3

post

https://{xentralId}.xentral.biz/api/v3/suppliers

This endpoint is currently in Beta and available for testing. It may contain bugs, and breaking changes can occur at any time without prior notice. We do not recommend using Beta endpoints in production environments. Should you choose to use it in production, you assume full responsibility for any resulting issues.

This endpoint requires the following scopes: supplier:create.

Create a new supplier.

Body Params

number

string

Supplier number

deviatingSupplierNumber

string

Deviating supplier account number for accounting

mainProject

object

Main project the supplier belongs to

primaryAddress

object

required

Primary address information for the supplier

deviatingBillingAddress

object

Deviating billing address information

communication

object

Communication preferences and settings

financials

object

Financial information and settings

fulfillment

object

Fulfillment and delivery settings

documentDelivery

object

Document delivery preferences

groups

array of objects

Groups the supplier belongs to

groups

supplierRoles

array of objects

Supplier roles associated with projects

supplierRoles

customFields

array of objects

Custom fields for additional custom data

customFields

notes

string

Notes for the supplier

supplierPurchaseNote

string | null

Supplier purchase note text

accountManager

object

Account manager reference

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

401

Unauthorized

403

Forbidden

Language

Credentials

Bearer

URL

Response

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

application/json

application/problem+json

201Create a new supplier.

400Failed validation

409Problem occurred

429Too Many Requests