Creates a supplier.

Endpoint URL

https://dashboard-api.revnue.com/api/v2/supplier

Authentication and rate limits

Item

Details

Authentication method

OAuth 2.0 Bearer token

Rate limit

Rate Limit

Requests Example

curl --request POST \
  --url 'https://dashboard-api.revnue.com/api/v2/supplier \
  --header 'Authorization: Bearer $BEARER_TOKEN' \
  --header 'Content-Type: application/json' \
  --data-raw '$JSON'

Request Syntax

{
    "company": integer,
    "name": "string",
    "category": integer,
    "contact_person":
    {
        "name": "string",
        "email": "string",
        "type": "account_management" | "billing" | "executive" | "sales" | "support" | "technical"
    },
    "address_line_1": "string",
    "address_line_2": "string",
    "city": "string",
    "state_province": "string",
    "zip_postal_code": "string",
    "country": integer,
    "phone": "string",
    "mobile": "string",
    "fax": "string",
    "website": "string",
    "general_description": "string",
    "type": "us" | "foreign",
    "business_name": "string",
    "business_address_line_1": "string",
    "business_address_line_2": "string",
    "business_city": "string",
    "business_state_province": "string",
    "business_zip_postal_code": "string",
    "business_country": integer,
    "ein": "string",
    "financial_description": "string",
    "nda_signed": true | false,
    "nda_signed_date": "string",
    "msa_signed": true | false,
    "msa_signed_date": "string",
    "supplementary_description": "string",
    "additional_description": "string",
    "template":
    {
        "id": integer,
        "fields": [
            {
                "id": integer,
                "value": decimal | integer | "string"
            }, 
        ]
    }
}

Query Parameters

  • company (integer) --

    [REQUIRED]
    The ID of the specific company your API is calling. For accounts with only one company, the default value is 1.
    To lookup a specific company ID, see the List Company API.

  • name (string) --

    [REQUIRED]
    The name of the supplier.
    Max characters = 50
    The name of the supplier must be unique per account.

  • category (integer) --

    The ID of the category.
    To lookup a specific category ID, see the List Category API.

  • contact_person (dict) --
    • name (string) --

      [REQUIRED] if email is defined
      The name of the contact person.
      Max characters = 50

    • email (string) --

      [REQUIRED] if name is defined
      The email of the contact person.
      Max characters = 254

    • type (string) --

      The type of the contact person.
      Options: account_management | billing | executive | sales | support | technical

  • address_line_1 (string) --

    The address line 1 of the supplier.
    Max characters = 50

  • address_line_2 (string) --

    The address line 2 of the supplier.
    Max characters = 50

  • city (string) --

    The city associated to the supplier.
    Max characters = 50

  • state_province (string) --

    The state/province associated to the supplier.
    Max characters = 50

  • zip_postal_code (string) --

    The zip/postal code associated to the supplier.
    Max characters = 20

  • country (integer) --

    The numeric code of the country.
    To lookup a specific country numeric code, see the List Country API.

  • phone (string) --

    The phone of the supplier.
    Max characters = 20

  • mobile (string) --

    The mobile of the supplier.
    Max characters = 20

  • fax (string) --

    The fax of the supplier.
    Max characters = 20

  • website (string) --

    The website of the supplier.
    Max characters = 50

  • general_description (string) --

    The general description of the supplier.
    Max characters = 1000

  • type (string) --

    The type of the supplier.
    Options: us | foreign

  • business_name (string) --

    The business name of the supplier.
    Max characters = 50

  • business_address_line_1 (string) --

    The business address line 1 of the supplier.
    Max characters = 50

  • business_address_line_2 (string) --

    The business address line 2 of the supplier.
    Max characters = 50

  • business_city (string) --

    The business city associated to the supplier.
    Max characters = 50

  • business_state_province (string) --

    The business state/province associated to the supplier.
    Max characters = 50

  • business_zip_postal_code (string) --

    The business zip/postal code associated to the supplier.
    Max characters = 20

  • business_country (integer) --

    The numeric code of the business country.
    To lookup a specific country numeric code, see the List Country API.

  • ein (string) --

    The employer identification number (EIN) of the supplier.
    Required characters = 9

  • financial_description (string) --

    The financial description of the supplier.
    Max characters = 1000

  • nda_signed (boolean) --

    Whether the NDA has been signed by the supplier.
    Options: true | false

  • nda_signed_date (string) --

    The NDA signed date by the supplier.
    Format = yyyy-MM-dd

  • msa_signed (boolean) --

    Whether the MSA has been signed by the supplier.
    Options: true | false

  • msa_signed_date (string) --

    The MSA signed date by the supplier.
    Format = yyyy-MM-dd

  • supplementary_description (string) --

    The supplementary description of the supplier.
    Max characters = 1000

  • additional_description (string) --

    The additional description of the supplier.
    Max characters = 1000

  • template (dict) --
    • id (integer) --

      The ID of the custom field template.
      To lookup a specific custom field template ID, see the List Custom Field Template API.

    • fields (dict) --
      • id (integer) --

        The ID of the custom field.
        To lookup a specific field ID, see the List Custom Field Template API.

      • value (decimal | integer | string) --

        The value of the custom field.

        • If the value data-type is money (decimal) --

          Min value = 0.00
          Max value = 999999999999999.00

        • If the value data-type is number (integer) --

          Min value = -999999999999999
          Max value = 999999999999999

        • If the value data-type is date (string) --

          Format = yyyy-MM-dd

        • If the value data-type is text (string) --

          Max characters = 50

Response Syntax

{
  "id": integer,
  "name": "string",
  "category": {
    "id": integer,
    "name": "string"
  },
  "contact_person": {
    "name": "string",
    "email": "string",
    "type": "account_management"|"billing"|"executive"|"sales"|"support"|"technical"
  },
  "address_line_1": "string",
  "address_line_2": "string",
  "city": "string",
  "state_province": "string",
  "zip_postal_code": "string",
  "country": "string",
  "phone": "string",
  "mobile": "string",
  "fax": "string",
  "website": "string",
  "general_description": "string",
  "type": "us"|"foreign",
  "business_name": "string",
  "business_address_line_1": "string",
  "business_address_line_2": "string",
  "business_city": "string",
  "business_state_province": "string",
  "business_zip_postal_code": "string",
  "business_country": "string",
  "ein": "string",
  "financial_description": "string",
  "nda_signed": true|false,
  "nda_signed_date": "string",
  "msa_signed": true|false,
  "msa_signed_date": "string",
  "supplementary_description": "string",
  "additional_description": "string",
  "template":{
    "id": integer,
    "fields":{
         key: value,...
    }
  }
}

Response Fields

  • id (integer) --

    The ID of the supplier.

  • name (string) --

    The name of the supplier.

  • category (dict) --

    The description of the category properties.

    • id (integer) --

      The ID of the category.

    • name (string) --

      The name of the category.

  • contact_person (dict) --

    The description of the contact person properties.

    • name (string) --

      The name of the contact person.

    • email (string) --

      The email of the contact person.

    • type (string) --

      The type of the contact person.

  • address_line_1 (string) --

    The address line 1 of the supplier.

  • address_line_2 (string) --

    The address line 2 of the supplier.

  • city (string) --

    The city associated to the supplier.

  • state_province (string) --

    The state/province associated to the supplier.

  • zip_postal_code (string) --

    The zip/postal code associated to the supplier.

  • country (string) --

    The country associated to the supplier.

  • phone (string) --

    The phone of the supplier.

  • mobile (string) --

    The mobile of the supplier.

  • fax (string) --

    The fax of the supplier.

  • general_description (string) --

    The general description of the supplier.

  • type (string) --

    The type of the supplier.

  • business_name (string) --

    The business name of the supplier.

  • business_address_line_1 (string) --

    The business address line 1 of the supplier.

  • business_address_line_2 (string) --

    The business address line 2 of the supplier.

  • business_city (string) --

    The business city associated to the supplier.

  • business_state_province (string) --

    The business state/province associated to the supplier.

  • business_zip_postal_code (string) --

    The business zip/postal code associated to the supplier.

  • business_country (string) --

    The business country associated to the supplier.

  • ein (string) --

    The employer identification number (EIN) of the supplier.

  • financial_description (string) --

    The financial description of the supplier.

  • nda_signed (boolean) --

    Whether the NDA has been signed by the supplier.

  • nda_signed_date (string) --

    The NDA signed date by the supplier.

  • msa_signed (boolean) --

    Whether the MSA has been signed by the supplier.

  • msa_signed_date (string) --

    The MSA signed date by the supplier.

  • supplementary_description (string) --

    The supplementary description of the supplier.

  • additional_description (string) --

    The additional description of the supplier.

  • template (dict) --

    The description of the custom field properties.

    • id (integer) --

      The ID of the custom field template.

    • fields (dict) --

      The custom fields and their values as defined in the custom field template. The data type of each custom field value varies depending on its definition.