Saaslogic
  1. Vendors
Saaslogic
  • Introduction
  • Authentication
  • Enum Reference
  • Authentication
    • saaslogic token
      • Get the saaslogic access token
    • login Url
      • Gives the login URL
    • logout Url
      • Gives the logout URL
  • Countries
    • Get list of countries
  • Plans
    • List all plans for a product
  • Subscriptions
    • Create a product subscription
    • Retrieve a subscription
    • Create Customer and Subscription
    • Subscription with details permissions, menus and features
    • The Saaslogic URL for creating subscription
  • Usage Reporting
    • Report the resource usages in subscription for invoicing
    • Retrieves the resource usages of a subscription in the current billing cycle
  • Customers
    • addresses
      • Create an address
      • List all addresses
      • Update an address
      • Retrieve an address
      • Delete an address
    • contacts
      • Create a contact
      • List all contacts
      • Update a contact
      • Retrieve a contact
      • Delete a contact
    • Create a customer
    • List all customers
    • Update a customer
    • Retrieve a customer
    • Delete a customer
  • Vendors
    • vendor addresses
      • Create a vendor address.
      • List all vendor addresses.
      • Update a vendor address.
      • Retrieve a vendor address..
      • Delete a vendor address.
    • vendor contacts
      • Create a vendor contact.
      • List all vendor contacts.
      • Update a vendor contact.
      • Retrieve a vendor contact.
      • Delete a vendor contact.
    • vendor bills
      • Create a vendor bill
      • Cancel a vendor bill.
    • vendor bills payout
      • Update payment details to vendor bills.
    • Create a vendor
      POST
    • Update a vendor.
      PUT
    • Activate a vendor.
      PUT
    • Dectivate a vendor.
      PUT
  • Attributes
    • Create a organization attribute and set the value
    • Retrieve a organization attribute
    • Create a user attribute
    • Update a user attribute
    • Get a user attribute
  • Invoices
    • subscriptions
      • Get the invoices
      • Get the invoices by subscription
    • payments
      • Mark the invoice payment status
    • Get the invoice details .
    • cancel the invoices
    • Send invoice as pdf with payment link.
    • Create an on-demand invoice
  1. Vendors

Create a vendor

POST
/vendors
Vendors
Creating a new vendor.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-sandbox.saaslogic.io/v1/vendors' \
--header 'Authorization;' \
--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 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
    }
  ]
}

Request

Header Params
Authorization
string 
required
Saaslogic authorization token
Default:
Bearer {{bearerToken}}
Content-Type
string 
optional
Default:
application/json
Accept
string 
optional
Default:
application/json
Body Params application/json
vendorId
string 
required
The ID of the vendor.
vendorName
string 
required
The name of the vendor.
taxId
string 
required
The tax identification number of the vendor.
contacts
array [object {7}] 
required
The list of contacts associated with the vendor.
contactId
string 
required
The ID of the contact.
firstName
string 
required
The first name of the contact.
lastName
string 
required
The last name of the contact.
email
string 
required
The email address of the contact.
contactNumber
string 
required
The phone number of the contact.
countryCode
string 
required
The country code associated with the contact number.
isDefault
boolean 
required
The flag indicating if this is the default contact.
addresses
array [object {8}] 
required
The list of addresses associated with the vendor.
addressId
string 
required
The ID of the address.
addressName
string 
required
The name or label of the address.
address
string 
required
The street address or detailed location of the vendor.
countryCode
string 
required
The country code associated with the address.
stateCode
string 
required
The state or region code of the address.
city
string 
required
The city of the address.
zip
string 
required
The postal code of the address.
isDefault
boolean 
required
The flag indicating if this is the default address.
Examples

Responses

🟢200Vendor created successfully
application/json
Body
vendorId
string 
required
vendorName
string 
required
taxId
string 
required
contacts
array [object {9}] 
required
contactId
string 
required
firstName
string 
required
lastName
string 
required
email
string 
optional
contactNumber
string 
required
countryPrefix
string 
required
countryCode
string 
required
isDefault
boolean 
required
emailAddress
string 
optional
addresses
array [object {8}] 
required
addressId
string 
required
addressName
string 
required
address
string 
required
countryCode
string 
required
stateCode
string 
required
city
string 
required
zip
string 
required
isDefault
boolean 
required
🔴500ErrorResponse
Previous
Update payment details to vendor bills.
Next
Update a vendor.
Built with