Create a vendor

POST

/vendors

Creating a new vendor.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Vendor created successfully

application/json

Body

🔴500ErrorResponse

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api-sandbox.saaslogic.io/v1/vendors' \
--header 'Authorization: Bearer ' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
  "vendorId": "a12bc3d4-5678-90ef-gh12-ijkl34567890",
  "vendorName": "Global Supplies Inc.",
  "taxId": "TAX123456789",
  "contacts": [
    {
      "contactId": "12345abc-de67-890f-gh12-ijkl34567890",
      "firstName": "Sarah",
      "lastName": "Connor",
      "email": "sconnor@globalsupplies.com",
      "contactNumber": "9876543210",
      "countryCode": "USA",
      "isDefault": true
    },
    {
      "contactId": "67890def-gh12-3456-ijkl-mnop78901234",
      "firstName": "John",
      "lastName": "Doe",
      "email": "jdoe@globalsupplies.com",
      "contactNumber": "5555555555",
      "countryCode": "CAN",
      "isDefault": false
    }
  ],
  "addresses": [
    {
      "addressId": "bcdef123-4567-890a-bcde-fghij1234567",
      "addressName": "Global Supplies Main Office",
      "address": "123 Elm Street, Springfield, Illinois",
      "countryCode": "USA",
      "stateCode": "IL",
      "city": "Springfield",
      "zip": "62704",
      "isDefault": true
    },
    {
      "addressId": "mnop7890-1234-5678-qrst-uvwxy1234567",
      "addressName": "Global Supplies Canada Branch",
      "address": "456 Maple Avenue, Toronto, Ontario",
      "countryCode": "CAN",
      "stateCode": "ON",
      "city": "Toronto",
      "zip": "M5J 2N8",
      "isDefault": false
    }
  ]
}'

Response Example

200 - Vendor created successfully

{
  "vendorId": "a12bc3d4-5678-90ef-gh12-ijkl34567890",
  "vendorName": "Global Supplies Inc.",
  "taxId": "TAX123456789",
  "contacts": [
    {
      "contactId": "12345abc-de67-890f-gh12-ijkl34567890",
      "firstName": "Sarah",
      "lastName": "Connor",
      "email": "sconnor@globalsupplies.com",
      "contactNumber": "9876543210",
      "countryPrefix": "+91",
      "countryCode": "USA",
      "isDefault": true
    },
    {
      "contactId": "67890def-gh12-3456-ijkl-mnop78901234",
      "firstName": "John",
      "lastName": "Doe",
      "emailAddress": "jdoe@globalsupplies.com",
      "contactNumber": "5555555555",
      "countryPrefix": "+91",
      "countryCode": "CAN",
      "isDefault": false
    }
  ],
  "addresses": [
    {
      "addressId": "bcdef123-4567-890a-bcde-fghij1234567",
      "addressName": "Global Supplies Main Office",
      "address": "123 Elm Street, Springfield, Illinois",
      "countryCode": "USA",
      "stateCode": "IL",
      "city": "Springfield",
      "zip": "62704",
      "isDefault": true
    },
    {
      "addressId": "mnop7890-1234-5678-qrst-uvwxy1234567",
      "addressName": "Global Supplies Canada Branch",
      "address": "456 Maple Avenue, Toronto, Ontario",
      "countryCode": "CAN",
      "stateCode": "ON",
      "city": "Toronto",
      "zip": "M5J 2N8",
      "isDefault": false
    }
  ]
}

Update payment details to vendor bills.

Update a vendor.