# Create supplier

Create a new supplier record with site information and optional certifications.

Endpoint: POST /suppliers
Version: 3.0.0

## Request fields (application/json):

  - `unique_identifier` (string, required)
    This identifier will make each supplier site unique in our systems.

  - `parent_company_name` (string)
    Supplier parent company name.

  - `site_name` (string)
    Name of the supplier site.

  - `site_email` (string)
    Email address of the supplier site.

  - `site_address` (object, required)
    Postal address of an entity.

  - `site_address.country` (string)
    Two‑letter ISO country code. Taxonomy – COUNTRY
    Enum: "AD", "AE", "AF", "AG", "AI", "AL", "AM", "AO", "AQ", "AR", "AS", "AT", "AU", "AW", "AX", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BL", "BM", "BN", "BO", "BQ", "BR", "BS", "BT", "BV", "BW", "BY", "BZ", "CA", "CC", "CD", "CF", "CG", "CH", "CI", "CK", "CL", "CM", "CN", "CO", "CR", "CU", "CV", "CW", "CX", "CY", "CZ", "DE", "DJ", "DK", "DM", "DO", "DZ", "EC", "EE", "EG", "EH", "ER", "ES", "ET", "FI", "FJ", "FK", "FO", "FR", "GA", "GB", "GD", "GE", "GF", "GG", "GH", "GI", "GL", "GM", "GN", "GP", "GQ", "GR", "GS", "GT", "GU", "GW", "GY", "HK", "HM", "HN", "HR", "HT", "HU", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IR", "IS", "IT", "JE", "JM", "JO", "JP", "KE", "KG", "KH", "KI", "KM", "KN", "KP", "KR", "KW", "KY", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS", "LT", "LU", "LV", "LY", "MA", "MC", "MD", "ME", "MF", "MG", "MH", "MK", "ML", "MM", "MN", "MO", "MP", "MQ", "MR", "MS", "MT", "MU", "MV", "MW", "MX", "MY", "MZ", "NA", "NC", "NE", "NF", "NG", "NI", "NL", "NO", "NP", "NR", "NU", "NZ", "OM", "PA", "PE", "PF", "PG", "PH", "PK", "PL", "PM", "PN", "PR", "PS", "PT", "PW", "PY", "QA", "RE", "RO", "RS", "RU", "RW", "SA", "SB", "SC", "SD", "SE", "SG", "SH", "SI", "SJ", "SK", "SL", "SM", "SN", "SO", "SR", "SS", "ST", "SV", "SX", "SY", "SZ", "TC", "TD", "TF", "TG", "TH", "TJ", "TK", "TL", "TM", "TN", "TO", "TR", "TT", "TV", "TW", "TZ", "UA", "UG", "UM", "US", "UY", "UZ", "VA", "VC", "VE", "VG", "VI", "VN", "VU", "WF", "WS", "YE", "YT", "ZA", "ZM", "ZW"

  - `site_address.city` (string)

  - `site_address.postalCode` (string)

  - `site_address.street` (string)

  - `site_certifications` (array)
    Optional list of certifications for this supplier site.

  - `site_certifications.certification_name` (string, required)
    Enum: "4SUSTAINABILITY CHEM ADVANCED", "4SUSTAINABILITY CHEM BASIC", "4SUSTAINABILITY CHEM EXCELLENCE", "4SUSTAINABILITY CYCLE ADVANCED", "4SUSTAINABILITY CYCLE BASIC", "4SUSTAINABILITY MATERIALS ADVANCED", "4SUSTAINABILITY MATERIALS BASIC", "4SUSTAINABILITY MATERIALS EXCELLENCE", "4SUSTAINABILITY PEOPLE ADVANCED", "4SUSTAINABILITY PEOPLE BASIC", "4SUSTAINABILITY PLANET ADVANCED", "4SUSTAINABILITY PLANET BASIC", "4SUSTAINABILITY TRACE ADVANCED", "4SUSTAINABILITY TRACE BASIC", "AGREMENT ATELIER CHANTIER INSERTION", "AGREMENT ENTREPRISE ADAPTÉE", "AGREMENT ENTREPRISE INSERTION", "AGREMENT ESAT", "ASC", "B CORPORATION", "BCI MEMBERSHIP", "BEPI ADVANCED", "BEPI BASIC", "BEPI GOOD", "BLUESIGN SYSTEM PARTNER", "BSCI GRADE A", "BSCI GRADE B", "BSCI GRADE C", "BSCI GRADE D", "BSCI GRADE E", "CANOPYSTYLE AUDIT", "CAREGORA", "CONTROL UNION FAIR CHOICE", "COPPER MARK", "CVFR", "DETOX TO ZERO BY OEKO-TEX", "ELEVATE RESPONSIBLE SOURCING ASSESSMENT", "ENTREPRISE DU PATRIMOINE VIVANT", "FAIR FOR LIFE", "FAIR WEAR FOUNDATION", "FAIRTRADE FIBRE CROPS STANDARD - CONTRACT PRODUCTION ORGANIZATION", "FAIRTRADE FIBRE CROPS STANDARD - SMALL PRODUCER ORGANIZATION", "FAIRTRADE FIBRE CROPS STANDARD - TRADER", "FAIRTRADE TEXTILE STANDARD - TRADER", "FAITRADE CLIMATE STANDARD", "FAITRADE CLIMATE STANDARD - TRADER", "GREEN TO WEAR BY INDITEX GRADE A", "GREEN TO WEAR BY INDITEX GRADE B", "GREEN TO WEAR BY INDITEX GRADE C", "GREEN TO WEAR BY INDITEX GRADE D", "GREENSCREEN FOR SAFER CHEMICALS", "ICCAW", "ICFA", "ICS GRADE A", "ICS GRADE B", "ICS GRADE C", "ICS GRADE D", "ICS GRADE E", "IFOAM", "ILO", "IRMA 50", "ISO 14001", "ISO 26000", "ISO 45001", "ISO 50001", "ISO 9001", "ISO/TS 34700", "LBMA", "LWG", "LWG COMMISSIONING MANUFACTURER - BRONZE", "LWG COMMISSIONING MANUFACTURER - GOLD", "LWG COMMISSIONING MANUFACTURER - SILVER", "LWG LEATHER MANUFACTURER - BRONZE", "LWG LEATHER MANUFACTURER - GOLD", "LWG LEATHER MANUFACTURER - SILVER", "LWG SUBCONTRACTOR", "LWG TRADER", "OEKO-TEX® ECO PASSPORT", "OEKO-TEX® ORGANIC COTTON", "QIMA ETHICAL AUDIT REPORT", "REACH", "REGENEVATE", "RESPONSIBLE REPTILE SOURCING STANDARD", "RESPONSIBLE SOURCING STANDARD", "RJC CODE OF PRACTICES", "SA8000", "SA8000 STANDARD GRADE 1", "SA8000 STANDARD GRADE 2", "SA8000 STANDARD GRADE 3", "SA8000 STANDARD GRADE 4", "SA8000 STANDARD GRADE 5", "SMETA 2-PILLAR", "SMETA 4-PILLAR", "STEP BY OEKOTEX", "SUPPLIER QUALIFICATION PROGRAM", "SWISS BETTER GOLD LEVEL 1", "SWISS BETTER GOLD LEVEL 2", "SWISS BETTER GOLD LEVEL 3", "TESSILE E SALUTE", "THINK GREEN INITIATIVE", "TISSU FRANCE TERRE TEXTILE", "UNI PDR 125:2022", "USDA ORGANIC", "VERIFIED_GRAPHENE_PRODUCER", "WFTO", "WRAP", "WRAP GOLD", "WRAP PLATINUM", "WRAP SILVER", "Welfare Quality® Assessement protocol", "ZDHC CMS", "ZDHC LEVEL 0", "ZDHC LEVEL 1", "ZDHC LEVEL 2", "ZDHC LEVEL 3", "ZDHC WMS"

  - `site_certifications.certification_file_id` (string)
    Identifier of a file attached as proof of certification.

## Response 201 fields (application/json):

  - `supplier_id` (string)
    System-generated identifier of the created supplier.