Creates an object of type vendor in Dynamics 365 Business Central

Request

Security

oAuthoauth2 (OAuth 2.0)
OAuth2oauth2 (OAuth 2.0)

Path

company_idstring (uuid)required
(v1.0) id for company

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1

Headers

Content-Typestringrequired
(v1.0) application/json

Body application/json required

idstring (uuid)
(v1.0) The id property for the Dynamics 365 Business Central vendor entity

Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
numberstring
(v1.0) The number property for the Dynamics 365 Business Central vendor entity

Example: null
<= 20 characters
displayNamestring
(v1.0) The displayName property for the Dynamics 365 Business Central vendor entity

Example: null
<= 100 characters
phonenumberstring
(v1.0) The phoneNumber property for the Dynamics 365 Business Central vendor entity

Example: null
<= 30 characters
emailstring
(v1.0) The email property for the Dynamics 365 Business Central vendor entity

Example: null
<= 80 characters
websitestring
(v1.0) The website property for the Dynamics 365 Business Central vendor entity

Example: null
<= 80 characters
taxRegistrationnumberstring
(v1.0) The taxRegistrationNumber property for the Dynamics 365 Business Central vendor entity

Example: null
<= 20 characters
currencyIdstring (uuid)
(v1.0) The currencyId property for the Dynamics 365 Business Central vendor entity

Example: null
currencycodestring
(v1.0) The currencyCode property for the Dynamics 365 Business Central vendor entity

Example: null
irs1099codestring
(v1.0) The irs1099Code property for the Dynamics 365 Business Central vendor entity

Example: null
paymentTermsIdstring (uuid)
(v1.0) The paymentTermsId property for the Dynamics 365 Business Central vendor entity

Example: null
paymentMethodIdstring (uuid)
(v1.0) The paymentMethodId property for the Dynamics 365 Business Central vendor entity

Example: null
taxLiableboolean
(v1.0) The taxLiable property for the Dynamics 365 Business Central vendor entity

Example: null
blockedstring
(v1.0) The blocked property for the Dynamics 365 Business Central vendor entity

Example: null
balancenumber (decimal)
(v1.0) The balance property for the Dynamics 365 Business Central vendor entity

Example: null
lastModifiedDateTimestring (date-time)
(v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central vendor entity

Example: null

Responses

(v1.0) A new vendor has been succesfully created

Body application/json

idstring (uuid)
(v1.0) The id property for the Dynamics 365 Business Central vendor entity

Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
numberstring
(v1.0) The number property for the Dynamics 365 Business Central vendor entity

Example: null
<= 20 characters
displayNamestring
(v1.0) The displayName property for the Dynamics 365 Business Central vendor entity

Example: null
<= 100 characters
phoneNumberstring
(v1.0) The phoneNumber property for the Dynamics 365 Business Central vendor entity

Example: null
<= 30 characters
emailstring
(v1.0) The email property for the Dynamics 365 Business Central vendor entity

Example: null
<= 80 characters
websitestring
(v1.0) The website property for the Dynamics 365 Business Central vendor entity

Example: null
<= 80 characters
taxRegistrationNumberstring
(v1.0) The taxRegistrationNumber property for the Dynamics 365 Business Central vendor entity

Example: null
<= 20 characters
currencyIdstring (uuid)
(v1.0) The currencyId property for the Dynamics 365 Business Central vendor entity

Example: null
currencyCodestring
(v1.0) The currencyCode property for the Dynamics 365 Business Central vendor entity

Example: null
irs1099Codestring
(v1.0) The irs1099Code property for the Dynamics 365 Business Central vendor entity

Example: null
paymentTermsIdstring (uuid)
(v1.0) The paymentTermsId property for the Dynamics 365 Business Central vendor entity

Example: null
paymentMethodIdstring (uuid)
(v1.0) The paymentMethodId property for the Dynamics 365 Business Central vendor entity

Example: null
taxLiableboolean
(v1.0) The taxLiable property for the Dynamics 365 Business Central vendor entity

Example: null
blockedstring
(v1.0) The blocked property for the Dynamics 365 Business Central vendor entity

Example: null
balancenumber (decimal)
(v1.0) The balance property for the Dynamics 365 Business Central vendor entity

Example: null
lastModifiedDateTimestring (date-time)
(v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central vendor entity

Example: null
pictureArray of objects (picture)
Show 6 properties
- idstring (uuid)
  (v1.0) The id property for the Dynamics 365 Business Central picture entity
  
  Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
- widthinteger (int32)
  (v1.0) The width property for the Dynamics 365 Business Central picture entity
  
  Example: null
- heightinteger (int32)
  (v1.0) The height property for the Dynamics 365 Business Central picture entity
  
  Example: null
- contentTypestring
  (v1.0) The contentType property for the Dynamics 365 Business Central picture entity
  
  Example: null
  <= 100 characters
- content@odata.mediaEditLinkstring (uri)
  (v1.0) The content@odata.mediaEditLink property for the Dynamics 365 Business Central picture entity
  
  Example: null
- content@odata.mediaReadLinkstring (uri)
  (v1.0) The content@odata.mediaReadLink property for the Dynamics 365 Business Central picture entity
  
  Example: null
defaultDimensionsArray of objects (defaultDimensions)
Show 9 properties
- parentIdstring (uuid)
  (v1.0) The parentId property for the Dynamics 365 Business Central defaultDimensions entity
  
  Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
- dimensionIdstring (uuid)
  (v1.0) The dimensionId property for the Dynamics 365 Business Central defaultDimensions entity
  
  Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
- dimensionCodestring
  (v1.0) The dimensionCode property for the Dynamics 365 Business Central defaultDimensions entity
  
  Example: null
  <= 20 characters
- dimensionValueIdstring (uuid)
  (v1.0) The dimensionValueId property for the Dynamics 365 Business Central defaultDimensions entity
  
  Example: null
- dimensionValueCodestring
  (v1.0) The dimensionValueCode property for the Dynamics 365 Business Central defaultDimensions entity
  
  Example: null
  <= 20 characters
- postingValidationstring
  (v1.0) The postingValidation property for the Dynamics 365 Business Central defaultDimensions entity
  
  Example: null
- accountobject (account)
  Show 7 properties
  - idstring (uuid)
    (v1.0) The id property for the Dynamics 365 Business Central account entity
    
    Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
  - numberstring
    (v1.0) The number property for the Dynamics 365 Business Central account entity
    
    Example: null
    <= 20 characters
  - displayNamestring
    (v1.0) The displayName property for the Dynamics 365 Business Central account entity
    
    Example: null
    <= 100 characters
  - categorystring
    (v1.0) The category property for the Dynamics 365 Business Central account entity
    
    Example: null
  - subCategorystring
    (v1.0) The subCategory property for the Dynamics 365 Business Central account entity
    
    Example: null
    <= 80 characters
  - blockedboolean
    (v1.0) The blocked property for the Dynamics 365 Business Central account entity
    
    Example: null
  - lastModifiedDateTimestring (date-time)
    (v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central account entity
    
    Example: null
- dimensionobject (dimension)
  Show 5 properties
  - idstring (uuid)
    (v1.0) The id property for the Dynamics 365 Business Central dimension entity
    
    Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
  - codestring
    (v1.0) The code property for the Dynamics 365 Business Central dimension entity
    
    Example: null
    <= 20 characters
  - displayNamestring
    (v1.0) The displayName property for the Dynamics 365 Business Central dimension entity
    
    Example: null
    <= 30 characters
  - lastModifiedDateTimestring (date-time)
    (v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central dimension entity
    
    Example: null
  - dimensionValuesArray of objects (dimensionValue)
    Show 4 properties
    idstring (uuid)
    (v1.0) The id property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
    codestring
    (v1.0) The code property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: null
    <= 20 characters
    displayNamestring
    (v1.0) The displayName property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: null
    <= 50 characters
    lastModifiedDateTimestring (date-time)
    (v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: null
- dimensionValueobject (dimensionValue)
  Show 4 properties
  - idstring (uuid)
    (v1.0) The id property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
  - codestring
    (v1.0) The code property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: null
    <= 20 characters
  - displayNamestring
    (v1.0) The displayName property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: null
    <= 50 characters
  - lastModifiedDateTimestring (date-time)
    (v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central dimensionValue entity
    
    Example: null
currencyobject (currency)
Show 7 properties
- idstring (uuid)
  (v1.0) The id property for the Dynamics 365 Business Central currency entity
  
  Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
- codestring
  (v1.0) The code property for the Dynamics 365 Business Central currency entity
  
  Example: BKSD94GH
  <= 10 characters
- displayNamestring
  (v1.0) The displayName property for the Dynamics 365 Business Central currency entity
  
  Example: null
  <= 30 characters
- symbolstring
  (v1.0) The symbol property for the Dynamics 365 Business Central currency entity
  
  Example: null
  <= 10 characters
- amountDecimalPlacesstring
  (v1.0) The amountDecimalPlaces property for the Dynamics 365 Business Central currency entity
  
  Example: null
  <= 5 characters
- amountRoundingPrecisionnumber (decimal)
  (v1.0) The amountRoundingPrecision property for the Dynamics 365 Business Central currency entity
  
  Example: null
- lastModifiedDateTimestring (date-time)
  (v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central currency entity
  
  Example: null
paymentTermobject (paymentTerm)
Show 8 properties
- idstring (uuid)
  (v1.0) The id property for the Dynamics 365 Business Central paymentTerm entity
  
  Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
- codestring
  (v1.0) The code property for the Dynamics 365 Business Central paymentTerm entity
  
  Example: JKHB9XER3
  <= 10 characters
- displayNamestring
  (v1.0) The displayName property for the Dynamics 365 Business Central paymentTerm entity
  
  Example: null
  <= 100 characters
- dueDateCalculationstring
  (v1.0) The dueDateCalculation property for the Dynamics 365 Business Central paymentTerm entity
  
  Example: null
- discountDateCalculationstring
  (v1.0) The discountDateCalculation property for the Dynamics 365 Business Central paymentTerm entity
  
  Example: null
- discountPercentnumber (decimal)
  (v1.0) The discountPercent property for the Dynamics 365 Business Central paymentTerm entity
  
  Example: null
- calculateDiscountOnCreditMemosboolean
  (v1.0) The calculateDiscountOnCreditMemos property for the Dynamics 365 Business Central paymentTerm entity
  
  Example: null
- lastModifiedDateTimestring (date-time)
  (v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central paymentTerm entity
  
  Example: null
paymentMethodobject (paymentMethod)
Show 4 properties
- idstring (uuid)
  (v1.0) The id property for the Dynamics 365 Business Central paymentMethod entity
  
  Example: 2a2dfc50-f21b-4ab0-8f89-463efd0dfce4
- codestring
  (v1.0) The code property for the Dynamics 365 Business Central paymentMethod entity
  
  Example: PM-001
  <= 10 characters
- displayNamestring
  (v1.0) The displayName property for the Dynamics 365 Business Central paymentMethod entity
  
  Example: null
  <= 100 characters
- lastModifiedDateTimestring (date-time)
  (v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central paymentMethod entity
  
  Example: null

post /companies({company_id})/vendors

curl -X POST \
  'https://www.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/vendors' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
  "number": null,
  "displayName": null,
  "phonenumber": null,
  "email": null,
  "website": null,
  "taxRegistrationnumber": null,
  "currencyId": null,
  "currencycode": null,
  "irs1099code": null,
  "paymentTermsId": null,
  "paymentMethodId": null,
  "taxLiable": null,
  "blocked": null,
  "balance": null,
  "lastModifiedDateTime": null
}'

const url = 'https://www.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/vendors';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json', Authorization: 'Bearer <YOUR_TOKEN_HERE>'},
  body: '{"id":"2a2dfc50-f21b-4ab0-8f89-463efd0dfce4","number":null,"displayName":null,"phonenumber":null,"email":null,"website":null,"taxRegistrationnumber":null,"currencyId":null,"currencycode":null,"irs1099code":null,"paymentTermsId":null,"paymentMethodId":null,"taxLiable":null,"blocked":null,"balance":null,"lastModifiedDateTime":null}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

const fetch = require('node-fetch');

const url = 'https://www.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/vendors';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json', Authorization: 'Bearer <YOUR_TOKEN_HERE>'},
  body: '{"id":"2a2dfc50-f21b-4ab0-8f89-463efd0dfce4","number":null,"displayName":null,"phonenumber":null,"email":null,"website":null,"taxRegistrationnumber":null,"currencyId":null,"currencycode":null,"irs1099code":null,"paymentTermsId":null,"paymentMethodId":null,"taxLiable":null,"blocked":null,"balance":null,"lastModifiedDateTime":null}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

import requests

url = "https://www.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/vendors"

payload = {
  "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
  "number": None,
  "displayName": None,
  "phonenumber": None,
  "email": None,
  "website": None,
  "taxRegistrationnumber": None,
  "currencyId": None,
  "currencycode": None,
  "irs1099code": None,
  "paymentTermsId": None,
  "paymentMethodId": None,
  "taxLiable": None,
  "blocked": None,
  "balance": None,
  "lastModifiedDateTime": None
}
headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer <YOUR_TOKEN_HERE>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n  \"id\": \"2a2dfc50-f21b-4ab0-8f89-463efd0dfce4\",\n  \"number\": null,\n  \"displayName\": null,\n  \"phonenumber\": null,\n  \"email\": null,\n  \"website\": null,\n  \"taxRegistrationnumber\": null,\n  \"currencyId\": null,\n  \"currencycode\": null,\n  \"irs1099code\": null,\n  \"paymentTermsId\": null,\n  \"paymentMethodId\": null,\n  \"taxLiable\": null,\n  \"blocked\": null,\n  \"balance\": null,\n  \"lastModifiedDateTime\": null\n}");
Request request = new Request.Builder()
  .url("https://www.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/vendors")
  .post(body)
  .addHeader("Content-Type", "application/json")
  .addHeader("Authorization", "Bearer <YOUR_TOKEN_HERE>")
  .build();

Response response = client.newCall(request).execute();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://www.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/vendors"),
  Headers =
  {
    { "Authorization", "Bearer <YOUR_TOKEN_HERE>" },
  },
  Content = new StringContent("{\n  \"id\": \"2a2dfc50-f21b-4ab0-8f89-463efd0dfce4\",\n  \"number\": null,\n  \"displayName\": null,\n  \"phonenumber\": null,\n  \"email\": null,\n  \"website\": null,\n  \"taxRegistrationnumber\": null,\n  \"currencyId\": null,\n  \"currencycode\": null,\n  \"irs1099code\": null,\n  \"paymentTermsId\": null,\n  \"paymentMethodId\": null,\n  \"taxLiable\": null,\n  \"blocked\": null,\n  \"balance\": null,\n  \"lastModifiedDateTime\": null\n}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/vendors",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'id' => '2a2dfc50-f21b-4ab0-8f89-463efd0dfce4',
    'number' => null,
    'displayName' => null,
    'phonenumber' => null,
    'email' => null,
    'website' => null,
    'taxRegistrationnumber' => null,
    'currencyId' => null,
    'currencycode' => null,
    'irs1099code' => null,
    'paymentTermsId' => null,
    'paymentMethodId' => null,
    'taxLiable' => null,
    'blocked' => null,
    'balance' => null,
    'lastModifiedDateTime' => null
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <YOUR_TOKEN_HERE>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/vendors"

	payload := strings.NewReader("{\n  \"id\": \"2a2dfc50-f21b-4ab0-8f89-463efd0dfce4\",\n  \"number\": null,\n  \"displayName\": null,\n  \"phonenumber\": null,\n  \"email\": null,\n  \"website\": null,\n  \"taxRegistrationnumber\": null,\n  \"currencyId\": null,\n  \"currencycode\": null,\n  \"irs1099code\": null,\n  \"paymentTermsId\": null,\n  \"paymentMethodId\": null,\n  \"taxLiable\": null,\n  \"blocked\": null,\n  \"balance\": null,\n  \"lastModifiedDateTime\": null\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "Bearer <YOUR_TOKEN_HERE>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

Response

application/json

{
  "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
  "number": null,
  "displayName": null,
  "phoneNumber": null,
  "email": null,
  "website": null,
  "taxRegistrationNumber": null,
  "currencyId": null,
  "currencyCode": null,
  "irs1099Code": null,
  "paymentTermsId": null,
  "paymentMethodId": null,
  "taxLiable": null,
  "blocked": null,
  "balance": null,
  "lastModifiedDateTime": null,
  "picture": [
    {
      "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
      "width": null,
      "height": null,
      "contentType": null,
      "content@odata.mediaEditLink": null,
      "content@odata.mediaReadLink": null
    }
  ],
  "defaultDimensions": [
    {
      "parentId": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
      "dimensionId": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
      "dimensionCode": null,
      "dimensionValueId": null,
      "dimensionValueCode": null,
      "postingValidation": null,
      "account": {},
      "dimension": {
        "dimensionValues": []
      },
      "dimensionValue": {}
    }
  ],
  "currency": {
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "code": "BKSD94GH",
    "displayName": null,
    "symbol": null,
    "amountDecimalPlaces": null,
    "amountRoundingPrecision": null,
    "lastModifiedDateTime": null
  },
  "paymentTerm": {
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "code": "JKHB9XER3",
    "displayName": null,
    "dueDateCalculation": null,
    "discountDateCalculation": null,
    "discountPercent": null,
    "calculateDiscountOnCreditMemos": null,
    "lastModifiedDateTime": null
  },
  "paymentMethod": {
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "code": "PM-001",
    "displayName": null,
    "lastModifiedDateTime": null
  }
}

Creates an object of type vendor in Dynamics 365 Business Central

Request

Security

Path

Headers

Body application/json required

Responses201

Body application/json

Responses