Business Central - Methods — Wiresk Documentation

Estimated reading time: 8 min

BusinessCentral Business Central - Methods

AVAILABLE METHODS Copy Link

What your automation will do…

You can include between 1 and 255 Methods to build complex Flows.

Retrieve Records Copy Link

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature (⚡ icon).

(*) required field

Name*	Retrieve Records
Connection*	Select your connection or create one.
Entity*	The Business Central entity to query. Examples include customer, vendor, item, contact, or salesOrder. The available entities depend on the Business Central API and the permissions of the Connection.

Company Name*

Specifies which Business Central company to query.
If your tenant has multiple companies, this field is important.

You can:

Select a static company name, or
Map it dynamically from a previous Trigger or Method if your Flow works across multiple companies.

If not Found consider as

Success – When the record is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the Flow.

Failed – Wiresk treats this as an error or failure. The Flow stops or takes a predefined failure action.

Matching Criteria ⨁ Add Matching ↓

Fields

This is where you filter the records to retrieve.

Example: number, displayName, email, blocked, lastModifiedDateTime.

Operator

Defines how the field is compared to the value.

Operators include Equals, Does Not Equal, Is Empty, Is not Empty, Like, Not Like.

Sample response

[
  {
    "@odata.etag": "W/\"JzE5OzUxMjgzOTY2Mzc4MjkgNDM0NjgxOzAwOyc=\"",
    "id": "c333b1f5-3ab6-f011-bcd1-00224838e242",
    "number": "1028",
    "displayName": "NoName",
    "displayName2": "",
    "type": "Inventory",
    "itemCategoryId": "00000000-0000-0000-0000-000000000000",
    "itemCategoryCode": "",
    "blocked": false,
    "gtin": "",
    "inventory": 0,
    "unitPrice": 0,
    "priceIncludesTax": false,
    "unitCost": 0,
    "taxGroupId": "00000000-0000-0000-0000-000000000000",
    "taxGroupCode": "",
    "baseUnitOfMeasureId": "00000000-0000-0000-0000-000000000000",
    "baseUnitOfMeasureCode": "",
    "generalProductPostingGroupId": "00000000-0000-0000-0000-000000000000",
    "generalProductPostingGroupCode": "",
    "inventoryPostingGroupId": "00000000-0000-0000-0000-000000000000",
    "inventoryPostingGroupCode": "",
    "lastModifiedDateTime": "2025-10-31T09:21:22.16Z"
  }
  ]

Expand

Retrieve Record by ID Copy Link

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature (⚡ icon).

(*) required field

Name*	Retrieve Records
Connection*	Select your connection or create one.
Entity*	The Business Central entity to query. Examples include customer, vendor, item, contact, or salesOrder. The available entities depend on the Business Central API and the permissions of the Connection.

If not Found consider as

Success – When the record is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the Flow.

Failed – Wiresk treats this as an error or failure. The Flow stops or takes a predefined failure action.

Matching Criteria

Company Name*

Specifies which Business Central company to query.
If your tenant has multiple companies, this field is important.

You can:

Select a static company name, or
Map it dynamically from a previous Trigger or Method if your Flow works across multiple companies.

Record ID*

This is the unique internal ID of the record in Business Central.
This is not the item number or code visible to users. It is the system-generated ID used by the API.

You can:

Enter manually the ID
Map it dynamically from a previous Trigger or Method if your Flow works across multiple companies.

Sample response

[
  {
    "@odata.etag": "W/\"JzE5OzUxMjgzOTY2Mzc4MjkgNDM0NjgxOzAwOyc=\"",
    "id": "c333b1f5-3ab6-f011-bcd1-00224838e242",
    "number": "1028",
    "displayName": "NoName",
    "displayName2": "",
    "type": "Inventory",
    "itemCategoryId": "00000000-0000-0000-0000-000000000000",
    "itemCategoryCode": "",
    "blocked": false,
    "gtin": "",
    "inventory": 0,
    "unitPrice": 0,
    "priceIncludesTax": false,
    "unitCost": 0,
    "taxGroupId": "00000000-0000-0000-0000-000000000000",
    "taxGroupCode": "",
    "baseUnitOfMeasureId": "00000000-0000-0000-0000-000000000000",
    "baseUnitOfMeasureCode": "",
    "generalProductPostingGroupId": "00000000-0000-0000-0000-000000000000",
    "generalProductPostingGroupCode": "",
    "inventoryPostingGroupId": "00000000-0000-0000-0000-000000000000",
    "inventoryPostingGroupCode": "",
    "lastModifiedDateTime": "2025-10-31T09:21:22.16Z"
  }
  ]

Expand

Create Record Copy Link

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature (⚡ icon).

(*) required field

Name*	Create Record
Connection*	Select your connection or create one.
Entity*	The Business Central entity to query. Examples include customer, vendor, item, contact, or salesOrder. The available entities depend on the Business Central API and the permissions of the Connection.

Company Name*

Specifies which Business Central company to query.
If your tenant has multiple companies, this field is important.

You can:

Select a static company name, or
Map it dynamically from a previous Trigger or Method if your Flow works across multiple companies.

Mapping Fields ⨁ Add Mapping ↓

Fields

Defines the values used to build the new record payload.

Example of fields from customer entity

number
displayName
Type
addressLine1
addressLine2
City
state
Country
postalCode
phoneNumber
Email
website
salespersonCode
balanceDue
creditLimit
taxLiable
taxAreald
taxAreaDisplayName
taxRegistrationNumber
currencyld
currencyCode
paymentTermsld
shipmentMethodld
paymentMethodld
blocked
lastModifiedDateTime

Sample response

HTTP/1.1 201 Created
Content-type: application/json

{
    "id": "fca5738a-44e3-ea11-bb43-000d3a2feca1",
    "number": "1896-S",
    "displayName": "ATHENS Desk",
    "displayName2": "",
    "type": "Inventory",
    "itemCategoryId": "e21a6a90-44e3-ea11-bb43-000d3a2feca1",
    "itemCategoryCode": "TABLE",
    "blocked": false,
    "gtin": "",
    "inventory": 0,
    "unitPrice": 1000.8,
    "priceIncludesTax": false,
    "unitCost": 780.7,
    "taxGroupId": "9f196a90-44e3-ea11-bb43-000d3a2feca1",
    "taxGroupCode": "FURNITURE",
    "baseUnitOfMeasureId": "5ca6738a-44e3-ea11-bb43-000d3a2feca1",
    "baseUnitOfMeasureCode": "PCS",
    "generalProductPostingGroupId": "019b8ec1-d83d-ee11-be71-6045bde9cbf2",
    "generalProductPostingGroupCode": "RETAIL",
    "inventoryPostingGroupId": "039e8ec1-d83d-ee11-be71-6045bde9cbf2",
    "inventoryPostingGroupCode": "RESALE",
    "lastModifiedDateTime": "2020-08-21T00:24:19.347Z"
}

Expand

Upsert Record Copy Link

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature (⚡ icon).

(*) required field

Name*	Upsert Record
Connection*	Select your connection or create one.
Entity*	The Business Central entity to query. Examples include customer, vendor, item, contact, or salesOrder. The available entities depend on the Business Central API and the permissions of the Connection.

Matching Criteria ⨁ Add Matching ↓

Fields

Matching field of the record to be updated.

Example: number, displayName, email, blocked, lastModifiedDateTime.

Operator

Defines how the field is compared to the value.

Operators include Equals, Does Not Equal, Is Empty, Is not Empty, Like, Not Like.

Company Name*

Specifies which Business Central company to query.
If your tenant has multiple companies, this field is important.

You can:

Select a static company name, or
Map it dynamically from a previous Trigger or Method if your Flow works across multiple companies.

Allow Multiple Update*

Yes – No

Process update if found more than one record. (Note: this could update multiple-records with the searching criteria)

Mapping Fields ⨁ Add Mapping ↓

Fields

Defines the values used to build:

If the record is created (POST), these fields become the create payload.
If the record is updated (PATCH), these fields become the update payload.

Example of fields from customer entity

number
displayName
Type
addressLine1
addressLine2
City
state
Country
postalCode
phoneNumber
Email
website
salespersonCode
balanceDue
creditLimit
taxLiable
taxAreald
taxAreaDisplayName
taxRegistrationNumber
currencyld
currencyCode
paymentTermsld
shipmentMethodld
paymentMethodld
blocked
lastModifiedDateTime

Sample response when updating a record

[
  {
    "@odata.context": "https://api.businesscentral.dynamics.com/v2.0/8c2110ce-f3ed-4fdc-8384-f4e14c174529/Production/api/v2.0/$metadata#companies(31ee842c-7688-f011-b9d5-6045bde9963a)/customers/$entity",
    "@odata.etag": "W/\"JzE5OzMwMTgyOTUxNDQyMDQxOTA4MjgxOzAwOyc=\"",
    "id": "4744912e-05db-f011-8542-7ced8d83b309",
    "number": "321",
    "displayName": "test wiresk upsert",
    "type": "Company",
    "addressLine1": "",
    "addressLine2": "",
    "city": "",
    "state": "",
    "country": "",
    "postalCode": "",
    "phoneNumber": "",
    "email": "test@wiresk.com",
    "website": "",
    "salespersonCode": "",
    "balanceDue": 0,
    "creditLimit": 0,
    "taxLiable": false,
    "taxAreaId": "00000000-0000-0000-0000-000000000000",
    "taxAreaDisplayName": "",
    "taxRegistrationNumber": "",
    "currencyId": "00000000-0000-0000-0000-000000000000",
    "currencyCode": "EUR",
    "paymentTermsId": "00000000-0000-0000-0000-000000000000",
    "shipmentMethodId": "00000000-0000-0000-0000-000000000000",
    "paymentMethodId": "00000000-0000-0000-0000-000000000000",
    "blocked": "_x0020_",
    "lastModifiedDateTime": "2025-12-17T09:27:10.223Z"
  }
]

Expand

Update Record Copy Link

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature (⚡ icon).

(*) required field

Name*	Update Record
Connection*	Select your connection or create one.
Entity*	The Business Central entity to query. Examples include customer, vendor, item, contact, or salesOrder. The available entities depend on the Business Central API and the permissions of the Connection.

Matching Criteria

Company Name*

Specifies which Business Central company to query.
If your tenant has multiple companies, this field is important.

You can:

Select a static company name, or
Map it dynamically from a previous Trigger or Method if your Flow works across multiple companies.

Record ID*

The internal Business Central record identifier.
This is not the customer number or display name. It is the system-generated ID returned by previous Methods such as:

Retrieve Multiple Records
Retrieve a Record
Create Record
Upsert Record

Entity Tag*

Used for concurrency control in Business Central.

Business Central requires an ETag value to ensure the record has not been modified since it was last retrieved. This prevents overwriting changes made by another user or process.

The ETag must come from a previous GET response for the same record. If:

The ETag is missing, invalid, or outdated, the update will fail.
You retrieved the record earlier in the Flow, always reuse the returned ETag.

You will see @odata.etag in step response for dynamic mapping.

In Methods like:

Retrieve Multiple Records
Retrieve a Record
Create Record
Upsert Record

Mapping Fields ⨁ Add Mapping ↓

Fields

Defines which fields will be updated.

Only mapped fields are sent in the PATCH request.
Unmapped fields are not touched.

Note: Some fields are read-only or system-controlled and cannot be updated, even if they appear in the field list. Attempting to update them will cause an API error.

Example of fields from customer entity

number
displayName
Type
addressLine1
addressLine2
City
state
Country
postalCode
phoneNumber
Email
website
salespersonCode
balanceDue
creditLimit
taxLiable
taxAreald
taxAreaDisplayName
taxRegistrationNumber
currencyld
currencyCode
paymentTermsld
shipmentMethodld
paymentMethodld
blocked
lastModifiedDateTime

Sample response when updating a record

{
  "@odata.context": "https://api.businesscentral.dynamics.com/v2.0/8c2110ce-f3ed-4fdc-8384-f4e14c174529/Production/api/v2.0/$metadata#companies(31ee842c-7688-f011-b9d5-6045bde9963a)/customers/$entity",
  "@odata.etag": "W/\"JzE5Ozg2NzcyMDIzNzA1MjY2nzYwODUxOzAwOyc=\"",
  "id": "4744912e-05db-f011-8542-7ced8d83b309",
  "number": "321",
  "displayName": "updated customer",
  "type": "Company",
  "addressLine1": "",
  "addressLine2": "",
  "city": "",
  "state": "",
  "country": "",
  "postalCode": "",
  "phoneNumber": "",
  "email": "test@wiresk.com",
  "website": "",
  "salespersonCode": "",
  "balanceDue": 0,
  "creditLimit": 0,
  "taxLiable": false,
  "taxAreaId": "00000000-0000-0000-0000-000000000000",
  "taxAreaDisplayName": "",
  "taxRegistrationNumber": "",
  "currencyId": "00000000-0000-0000-0000-000000000000",
  "currencyCode": "EUR",
  "paymentTermsId": "00000000-0000-0000-0000-000000000000",
  "shipmentMethodId": "00000000-0000-0000-0000-000000000000",
  "paymentMethodId": "00000000-0000-0000-0000-000000000000",
  "blocked": "_x0020_",
  "lastModifiedDateTime": "2025-12-17T10:16:37.437Z"
}

Expand

Delete Record Copy Link

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature (⚡ icon).

(*) required field

Name*	Delete Record
Connection*	Select your connection or create one.
Entity*	The Business Central entity to query. Examples include customer, vendor, item, contact, or salesOrder. The available entities depend on the Business Central API and the permissions of the Connection.

Matching Criteria

Company Name*

Specifies which Business Central company to query.
If your tenant has multiple companies, this field is important.

You can:

Select a static company name, or
Map it dynamically from a previous Trigger or Method if your Flow works across multiple companies.

Record ID*

The internal Business Central record identifier.
This is not the customer number or display name. It is the system-generated ID returned by previous Methods such as:

Retrieve Multiple Records
Retrieve a Record
Create Record
Upsert Record

Sample response

{
  "message": "Record deleted successfully."
}

Expand

Test and automate your Flow Copy Link

Once your Flow is configured, you can test or automate it using the Run panel or by managing Triggers from the Flow Management screen.

Run Flow: Manually runs the Flow once using sample data. Ideal for testing logic and field mapping. See How to Run a Flow.
Run Scheduler: Force-runs the Trigger immediately using live input. This bypasses the recurrence rule and is useful for verifying real data mapping. Learn more in Wiresk Scheduler – The Fundamentals.

From the Trigger management panel (clock icon), you can:

Activate or deactivate Triggers
Force-run the scheduler
Copy Routing Keys (for HTTP Triggers)

If your Flow uses a Webhook Trigger, it runs automatically on each incoming webhook—no scheduler required. It remains active until you manually deactivate it.

Going further Copy Link

See related Microsoft apps.

Explore the full Wiresk User Guide to learn more.

Looking for an integration that’s not yet available? Submit a request to our team, we’ll do our best to support your needs.

Business Central – Methods

AVAILABLE METHODS Copy Link

Retrieve Records Copy Link

Retrieve Record by ID Copy Link

Create Record Copy Link

Upsert Record Copy Link

Update Record Copy Link

Delete Record Copy Link

Test and automate your Flow Copy Link

Going further Copy Link