Create Supplier
Create a new supplier (or reuse an existing one with the same fingerprint) and link it to your organization.
โถDedup behaviour
- New fingerprint โ a new global supplier row is inserted and
your organization's link is created. Status
201. - Existing fingerprint, no prior link from your organization โ
your organization is linked to the existing global row. Status
200. - Existing fingerprint, already linked to your organization โ
no-op idempotent reuse. Status
200. external_idalready linked AND any supplied body field disagrees with the stored supplier โ409 CONFLICT. POST is not an edit channel; usePATCH /parties/suppliers/{id}instead. Omitted fields never conflict โ a re-POST that only re-statesnameandexternal_idof the existing row is still a 200 no-op.
For the first three cases the response body is the joined supplier
view (identity fields from the global row + your organization's
external_id from the link).
โถAttributes
| Field | Type | Required | Description |
|---|---|---|---|
name | string | yes | 1โ512 chars |
address_line1 | string | null | no | โค512 chars |
address_line2 | string | null | no | โค512 chars |
city | string | null | no | โค512 chars |
region | string | null | no | โค512 chars |
postcode | string | null | no | โค512 chars |
country | string | null | no | ISO 3166-1 alpha-2; lower-case accepted |
statement | string | null | no | 1โ4000 chars |
external_id | string | null | no | โค256 chars; per-organization |
Invalid country codes, oversize fields, or unknown keys return
400. A duplicate external_id for your organization (already
bound to a different supplier) also returns 400.
Required scope:
parties:write