{"title":"CreateMultiple operation","url":"https://jonas-paprotka.de/docs/dev-itpro/webservices/createmultiple-operation/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/webservices/createmultiple-operation, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/webservices/createmultiple-operation","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Learn how to create multiple records with Microsoft's CreateMultiple Operation. Understand method signatures, parameters, results, and handle faults.","date":"2023-12-28","meta":{"topic":"article"},"outline":[{"level":2,"title":"Method signature","slug":"method-signature","at":114,"chars":63},{"level":2,"title":"Parameters","slug":"parameters","at":177,"chars":149},{"level":2,"title":"Results","slug":"results","at":326,"chars":257},{"level":2,"title":"Faults","slug":"faults","at":583,"chars":518},{"level":2,"title":"Usage example","slug":"usage-example","at":1101,"chars":241},{"level":2,"title":"Related information","slug":"related-information","at":1342,"chars":44}],"text":"Creates a set of records. The supplied record object is overwritten with the version that is created by the page.\n## Method signature\n`void CreateMultiple(ref Entity[] entity)`\n## Parameters\nParameter|Description\n*entity\\[\\]*|Type: An array of Entities<br /><br /> An array of a specific object type that represents the page.\n## Results\nResult name|Description\n*entity\\[\\]*|Type: An array of Entities<br /><br /> An array of a specific object type that represents the page. Contains the latest values that are present on the page after the records have been inserted into the table.\n## Faults\nSOAP fault message|Description\nThe \\[*record name*\\] already exists. Identification fields and values: \\[*field*\\]=\\[*value*\\]|Indicates that the insertion of at least one of the records would violate key constraints.\nOther faults are possible if they're generated by the AL code.\nThe CreateMultiple operation is executed as a single transaction unless the AL code explicitly commits the transaction. Either all or none of the records are inserted unless the application code doesn't explicitly call COMMIT.\n## Usage example\n```c#\nCustomer[] custArray = new Customer[3];\nfor (int i = 0; i < custArray.Length; i++)\n{\n  custArray[i] = new Customer();\n  custArray[i].Name = \"Customer Name \" + i.ToString();\n}\nservice.CreateMultiple(ref custArray);\n```\n## Related information\nbasic-page-operations"}