> ## Documentation Index > Fetch the complete documentation index at: https://help.polygon-one.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Supplier > Create a single supplier (synchronous), or bulk-import suppliers (asynchronous). Batch rows upsert idempotently on `externalSupplierId` (or name). **Batch form (array, or `{"rows": […]}` envelope, max 5000 rows) is asynchronous:** it stages an import job and returns `202` with a `jobId` — poll `GET /api/import-jobs/{jobId}` for progress and the final result. A single object stays synchronous (`201`). See the Batch Import guide. ## OpenAPI ````yaml POST /api/suppliers openapi: 3.1.0 info: title: Polygon One EUDR Compliance API description: >- API for integrating ERP systems with the Polygon One EUDR Compliance Platform. Allows management of Articles, Suppliers, Orders, and Due Diligence Statements (DDS). version: 1.0.0 servers: - url: https://app.polygon-one.com description: Production Server security: - bearerAuth: [] paths: /api/suppliers: post: summary: Create Supplier description: >- Create a single supplier (synchronous), or bulk-import suppliers (asynchronous). Batch rows upsert idempotently on `externalSupplierId` (or name). **Batch form (array, or `{"rows": […]}` envelope, max 5000 rows) is asynchronous:** it stages an import job and returns `202` with a `jobId` — poll `GET /api/import-jobs/{jobId}` for progress and the final result. A single object stays synchronous (`201`). See the Batch Import guide. operationId: createSupplier requestBody: required: true content: application/json: schema: oneOf: - $ref: '#/components/schemas/CreateSupplierInput' - type: array items: $ref: '#/components/schemas/CreateSupplierInput' maxItems: 5000 description: Batch import (bare array form) — asynchronous, returns 202 - type: object description: Batch envelope form (unknown extra keys are ignored) properties: rows: type: array items: $ref: '#/components/schemas/CreateSupplierInput' maxItems: 5000 required: - rows responses: '201': description: Supplier created successfully (single) content: application/json: schema: type: object properties: supplier: $ref: '#/components/schemas/Supplier' '202': $ref: '#/components/responses/BatchAccepted' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '413': $ref: '#/components/responses/PayloadTooLarge' '500': $ref: '#/components/responses/InternalError' components: schemas: CreateSupplierInput: type: object required: - name - email - country - address properties: name: type: string description: Supplier company name email: type: string format: email description: Supplier contact email country: type: string description: Country name (e.g. "Germany", "Brazil") address: $ref: '#/components/schemas/Address' contactName: type: string description: Contact person name externalSupplierId: type: string description: External ID from your ERP system associatedArticles: type: array items: type: string format: uuid description: List of existing article IDs to link to this supplier Supplier: type: object properties: id: type: string format: uuid name: type: string email: type: - string - 'null' contactName: type: - string - 'null' country: type: string externalSupplierId: type: - string - 'null' description: External ID from your ERP system address: $ref: '#/components/schemas/Address' status: $ref: '#/components/schemas/SupplierStatus' isCompanySelf: type: boolean description: >- True if this supplier represents your own company (for sale articles) articles: type: array items: $ref: '#/components/schemas/Article' Address: type: object required: - street - postalCode - city properties: street: type: string postalCode: type: string city: type: string additional: type: string validated: type: boolean latitude: type: number longitude: type: number SupplierStatus: type: string enum: - data_incomplete - data_complete - dds_submitted description: Supplier data completeness status Article: type: object properties: id: type: string format: uuid name: type: string internalArticleNr: type: string description: Internal article number (ERP ID) externalArticleNr: type: - string - 'null' hsCode: type: string description: Harmonized System code ean: type: - string - 'null' shortDescription: type: - string - 'null' eudrRelevant: type: boolean description: Automatically determined from HS code articleType: $ref: '#/components/schemas/ArticleType' commodityGroup: $ref: '#/components/schemas/CommodityGroup' suppliers: type: array items: $ref: '#/components/schemas/Supplier' complianceResults: type: array items: $ref: '#/components/schemas/ComplianceResult' countryOfProduction: type: - string - 'null' ImportJobAccepted: type: object description: >- Batch import staged as an async job. Nothing is imported yet — poll `statusUrl` for progress and the final result. properties: jobId: type: string format: uuid status: type: string enum: - queued statusUrl: type: string example: /api/import-jobs/6f7a… required: - jobId - status - statusUrl ErrorResponse: type: object properties: error: type: string details: description: Additional error details (e.g. validation issues) required: - error ArticleType: type: string enum: - purchase - sale description: >- `purchase` = inbound article from a supplier, `sale` = outbound article you sell CommodityGroup: type: string enum: - cattle - cocoa - coffee - oil_palm - rubber - soya - wood - non_relevant description: >- EUDR-regulated commodity groups. `non_relevant` = article is not covered by EUDR. ComplianceResult: type: object properties: id: type: string format: uuid supplierArticleId: type: string format: uuid overallStatus: $ref: '#/components/schemas/ComplianceStatus' geoStatus: $ref: '#/components/schemas/ComplianceStatus' legalStatus: $ref: '#/components/schemas/ComplianceStatus' generatedReportUrl: type: - string - 'null' generatedAt: type: - string - 'null' format: date-time updatedAt: type: string format: date-time ComplianceStatus: type: string enum: - compliant - non_compliant - invalid - unknown - not_eudr_relevant - pending_review - not_required_before_cutoff description: >- `invalid` = geolocation present but rejected as invalid (data-quality failure, blocks a compliant verdict until corrected); `not_required_before_cutoff` = article placed before the EUDR application date and not yet in scope. responses: BatchAccepted: description: >- Batch accepted — async import job staged. Nothing imported yet; poll the job. headers: Location: description: URL of the import job to poll schema: type: string content: application/json: schema: $ref: '#/components/schemas/ImportJobAccepted' BadRequest: description: Invalid request data content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Unauthorized: description: Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Forbidden: description: Insufficient permissions for this resource content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' PayloadTooLarge: description: >- Batch exceeds the row cap. Nothing staged — page the sync across multiple requests (orders: keep all lines of one order in the same request, see the Batch Import guide). content: application/json: schema: type: object properties: error: type: string enum: - batchTooLarge maxBatchSize: type: integer example: 5000 InternalError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- API key generated in Settings > API Keys. Include as `Authorization: Bearer `. ````