---
title: "Create a new supplier"
method: POST
path: "/v1/suppliers"
tags: ["Suppliers"]
---

# Create a new supplier

`POST /v1/suppliers`

## Request body

- Supplier — Supplier
  - `active` boolean — Whether the supplier is active
  - `address` AddressFields
    - `city` string, nullable
    - `countryIso` string, nullable
    - `countryName` string, nullable
    - `formattedAddress` string, nullable
    - `inlineAddress` string, nullable
    - `street` string, nullable
    - `zipcode` string, nullable
  - `cellPhone` string, nullable — Cell phone number
  - `companyInformations` CompanyInfo
    - `effectiveElectronicAddress` string, nullable
    - `electronicAddress` string, nullable
    - `siret` string, nullable
    - `vatNumber` string, nullable
  - `createdAt` string, date-time, nullable — Created date
  - `createdById` string, nullable — Created by user ID
  - `defaultPaymentMethod` 'Transfer' | 'Order' | 'Check' | 'Cash' | 'Card' | 'Bill' | 'Usec' | 'Other'
  - `email` string, nullable — Email
  - `firstName` string, nullable — First name
  - `id` integer — Supplier ID
  - `internalId` string, nullable — Internal Id
  - `internalNotes` string, nullable — Internal notes
  - `lastName` string, nullable — Last name
  - `name` string, nullable — Company name
  - `number` string, nullable — Number
  - `phone` string, nullable — Phone number
  - `title` string, nullable — Title
  - `updatedAt` string, date-time, nullable — Updated date
  - `updatedById` string, nullable — Updated by user ID

## Response `200`

OK

- Supplier — Supplier
  - `active` boolean — Whether the supplier is active
  - `address` AddressFields
    - `city` string, nullable
    - `countryIso` string, nullable
    - `countryName` string, nullable
    - `formattedAddress` string, nullable
    - `inlineAddress` string, nullable
    - `street` string, nullable
    - `zipcode` string, nullable
  - `cellPhone` string, nullable — Cell phone number
  - `companyInformations` CompanyInfo
    - `effectiveElectronicAddress` string, nullable
    - `electronicAddress` string, nullable
    - `siret` string, nullable
    - `vatNumber` string, nullable
  - `createdAt` string, date-time, nullable — Created date
  - `createdById` string, nullable — Created by user ID
  - `defaultPaymentMethod` 'Transfer' | 'Order' | 'Check' | 'Cash' | 'Card' | 'Bill' | 'Usec' | 'Other'
  - `email` string, nullable — Email
  - `firstName` string, nullable — First name
  - `id` integer — Supplier ID
  - `internalId` string, nullable — Internal Id
  - `internalNotes` string, nullable — Internal notes
  - `lastName` string, nullable — Last name
  - `name` string, nullable — Company name
  - `number` string, nullable — Number
  - `phone` string, nullable — Phone number
  - `title` string, nullable — Title
  - `updatedAt` string, date-time, nullable — Updated date
  - `updatedById` string, nullable — Updated by user ID

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/altoviz/apis/altoviz-api.md) · [All operations](https://skmtc.net/altoviz/apis/altoviz-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/altoviz/altoviz-api/revisions/e65392ac5b5f/schema)