CreateMultiple Action
Creates multiple records of the same type in a single request.
Bound Entities
Bound actions are invoked by appending the fully qualified action name to the URI representing an entity or collection.
| Entity Type | Binding Type |
|---|---|
| crmbaseentity | collection |
Parameters
Parameters allow for data to be passed to the action.
| Name | Type | Nullable | Unicode | Description |
|---|---|---|---|---|
|
Targets
|
Collection(crmbaseentity) | False | True | The records to create. |
Return Type
| Type | Nullable | Description |
|---|---|---|
| CreateMultipleResponse | False | The CreateMultiple action returns the following value. |
Entities
Use the CreateMultiple action with these entity types:
| Name | Display Name | Description |
|---|---|---|
| account | Account | Business that represents a customer or potential customer. The company that is billed in business transactions. |
| activityfileattachment | Activity File Attachment | Attachment entity with data stored in file type attribute |
| adx_externalidentity | External Identity | |
| adx_invitation | Invitation | Send invitations to existing contacts or email addresses and assign them to web roles upon redemption. |
| adx_inviteredemption | Invite Redemption | Holds information about the redemption of an invite. |
| adx_portalcomment | Portal Comment | An activity which is used to share information between the user and the customer on the portal. |
| adx_setting | Setting | |
| adx_webformsession | Multistep Form Session | Serves as a mechanism to log the occurrence of an incomplete multistep form entry for a given user so they can return and complete it later. |
| aiplugin | AIPlugin | AIPlugins component |
| aipluginexternalschema | AIPluginExternalSchema | AIPluginExternalSchemas component |
| aipluginexternalschemaproperty | AIPluginExternalSchemaProperty | AIPluginExternalSchemaProperties component |
| aiplugininstance | AIPluginInstance | AI Plugin Instances Component |
| aipluginoperation | AIPluginOperation | AIPluginOperations component |
| aipluginoperationparameter | AIPluginOperationParameter | Parameter overrides for AI Operation |
| aipluginusersetting | AIPluginUserSetting | |
| appaction | App Action | Contains Modern Command Information |
| appactionmigration | App Action Migration | |
| appactionrule | App Action Rule | |
| applicationuser | ApplicationUser | Application User that has non-interactive access to the CDS system |
| appnotification | Notification | Notification to be provided to a user. |
| backgroundoperation | Background Operation | |
| bot | Chatbot | Represents a Power Virtual Agents Chatbot. https://powerva.microsoft.com/ |
| botcomponent | Chatbot subcomponent | Holds key authoring components of a Chatbot such a topics, entities, variables, etc. |
| card | Card | Card |
| cardstateitem | Card State Item | |
| catalog | Catalog | Entity for cataloging records to make it easier for your customers to find them on portals and through search. |
| catalogassignment | Catalog Assignment | Entity for assigning records to a specific catalog |
| chat | Teams chat | For internal use only. Entity which stores association data of Dynamics 365 records with Microsoft Teams chat |
| componentversion | Component Version | |
| componentversiondatasource | Component Version Data Source | |
| componentversionnrddatasource | Component Version (Internal) | |
| connectioninstance | Connection Instance | |
| connectionreference | Connection Reference | |
| connector | Connector | Connector Entity to support Solutioning Integration |
| contact | Contact | Person with whom a business unit has a relationship, such as customer, supplier, and colleague. |
| conversationtranscript | ConversationTranscript | Contains the transcripts of conversations between participants such as customers, Virtual Agents or Human agents. |
| copilotexamplequestion | CopilotExampleQuestion | CopilotExampleQuestions Component |
| credential | Credential | |
| customapi | Custom API | Entity that defines a custom API |
| datalakefolder | Data Lake Folder | A folder is a place to store data in Azure Data Lake. |
| datalakeworkspace | Data Lake Workspace | A workspace is a place to store data in Azure Data Lake. |
| datalakeworkspacepermission | Data Lake Workspace Permission | |
| dataprocessingconfiguration | Data Processing configuration | |
| delegatedauthorization | DelegatedAuthorization | Context for delegated authorization. |
| deploymentorchestration | Deployment Orchestration | |
| desktopflowbinary | Desktop Flow Binary | |
| desktopflowmodule | Desktop Flow Module | |
| dvfilesearch | DVFileSearch | DVFileSearches Component |
| dvfilesearchattribute | DVFileSearchAttribute | |
| dvfilesearchentity | DVFileSearchEntity | DVFileSearchEntities component. |
| dvtablesearch | DVTableSearch | DVTableSearches component |
| dvtablesearchattribute | DVTableSearchAttribute | DVTableSearchAttribute component |
| dvtablesearchentity | DVTableSearchEntity | DVTableSearchEntities component |
| elasticfileattachment | ElasticFileAttachment | Elastic File Attachment |
| entityanalyticsconfig | Entity Analytics Config | This entity contains information about which entities are enabled for Azure Data Lake Services integration |
| entityrecordfilter | EntityRecordFilter | RecordFilter Object Type Codes |
| environmentvariabledefinition | Environment Variable Definition | Contains information about the settable variable: its type, default value, and etc. |
| environmentvariablevalue | Environment Variable Value | Holds the value for the associated EnvironmentVariableDefinition entity. |
| eventexpanderbreadcrumb | Event Expander Breadcrumb | Table to store breadcrumb records of Event Expander pipeline. |
| exportedexcel | Exported Excel | A Place holder entity to save excel file for each exportretaineddata custom api requests. |
| exportsolutionupload | ExportSolutionUpload | |
| featurecontrolsetting | FeatureControlSetting | featurecontrolsetting |
| flowcapacityassignment | Flow Capacity Assignment | Capacity assignment for usage in Power Automate |
| flowevent | Flow Event | Entity to store the events that happen during usage of Power Automate. |
| flowmachine | Flow Machine | |
| flowmachinegroup | Flow Machine Group | |
| flowmachineimage | Flow Machine Image | |
| flowmachineimageversion | Flow Machine Image Version | |
| flowmachinenetwork | Flow Machine Network | |
| flowrun | Flow Run | |
| flowsession | Flow Session | Entity to store the information that is generated when a Power Automate Desktop flow runs. |
| fxexpression | FxExpression | |
| keyvaultreference | Key Vault Reference | Contains data that refers to an Azure Key Vault containing credentials used to connect to secure web-hosted resources. |
| mainfewshot | MainFewShot | This fewshot entity will only be updated during solution installation. |
| makerfewshot | MakerFewShot | This fewshot is updated by maker for testing the queries and by the NL2SQ with the results |
| managedidentity | Managed Identity | Contains data to represent an Azure Active Directory Application used to connect to secure web-hosted resources. |
| maskingrule | Masking Rule | Masking Rules to apply to fields. |
| metadataforarchival | MetadataForArchival | Holds metadata values of tables for retention |
| mobileofflineprofileextension | MobileOfflineProfileExtension | |
| mobileofflineprofileitemfilter | MobileOfflineProfileItemFilter | |
| msdyn_aibdataset | AI Builder Dataset | |
| msdyn_aibdatasetfile | AI Builder Dataset File | |
| msdyn_aibdatasetrecord | AI Builder Dataset Record | |
| msdyn_aibdatasetscontainer | AI Builder Datasets Container | |
| msdyn_aibfeedbackloop | AI Builder Feedback Loop | |
| msdyn_aibfile | AI Builder File | |
| msdyn_aibfileattacheddata | AI Builder File Attached Data | |
| msdyn_aievent | AI Event | |
| msdyn_aifptrainingdocument | AI Form Processing Document | |
| msdyn_aimodel | AI Model | |
| msdyn_aiodimage | AI Object Detection Image | |
| msdyn_aiodlabel | AI Object Detection Label | |
| msdyn_aiodtrainingboundingbox | AI Object Detection Bounding Box | |
| msdyn_aiodtrainingimage | AI Object Detection Image Mapping | |
| msdyn_aitemplate | AI Template | |
| msdyn_analysiscomponent | Analysis Component | |
| msdyn_analysisjob | Analysis Job | |
| msdyn_analysisoverride | Analysis Override | |
| msdyn_analysisresult | Analysis Result | |
| msdyn_analysisresultdetail | Analysis Result Detail | |
| msdyn_appinsightsmetadata | App Insights Metadata | Metadata for App Insights Platform components |
| msdyn_connectordatasource | Virtual Connector Data Source | |
| msdyn_customcontrolextendedsettings | Custom Control Extended Setting | |
| msdyn_dataflow | Dataflow | |
| msdyn_dataflow_datalakefolder | Dataflow DatalakeFolder | |
| msdyn_dataflowconnectionreference | Dataflow Connection Reference | Intersecting table between Dataflow and Connection Reference |
| msdyn_dataflowrefreshhistory | DataflowRefreshHistory | |
| msdyn_dataflowtemplate | Dataflow Template | An entity to store information about dataflow templates |
| msdyn_datalakeds | Insights Store Data Source | |
| msdyn_dmsrequest | Data Movement Service Request | Table for Data Movement Service Requests |
| msdyn_dmsrequeststatus | Data Movement Service Request Status | Table for Data Movement Service Request Status |
| msdyn_dmssyncrequest | DMS Sync Request | An entity to save DMS sync requests. |
| msdyn_dmssyncstatus | DMS Sync Status | An entity to save DMS sync statuses. |
| msdyn_entitylinkchatconfiguration | Entity link chat configuration | |
| msdyn_entityrefreshhistory | EntityRefreshHistory | |
| msdyn_favoriteknowledgearticle | Favorite knowledge article | Entity for favorite knowledge articles |
| msdyn_federatedarticle | Knowledge Federated Article | |
| msdyn_federatedarticleincident | Knowledge Federated Article Incident | |
| msdyn_fileupload | File Upload | |
| msdyn_helppage | Help Page | |
| msdyn_insightsstorevirtualentity | Insights Store Virtual Entity | Insights Store Virtual Entity |
| msdyn_integratedsearchprovider | Integrated search provider | Ingest and search files, documents, or articles from data sources outside of your current Dynamics 365 organization with a unified ranking. |
| msdyn_kalanguagesetting | Knowledge article language setting | Allows you to select default language for knowledge authoring. |
| msdyn_kbattachment | Knowledge Article Attachment | |
| msdyn_kmfederatedsearchconfig | Search provider | |
| msdyn_kmpersonalizationsetting | Knowledge personalization | Allows users to personalize their knowledge search filters and knowledge authoring language. |
| msdyn_knowledgearticleimage | Knowledge Article Image | |
| msdyn_knowledgearticletemplate | Knowledge Article Template | Organizational Knowledge Article Template for Internal and external creation of Knowledge Articles. |
| msdyn_knowledgeconfiguration | Knowledge Configuration | Represents the possible settings used in Knowledge management |
| msdyn_knowledgeinteractioninsight | Knowledge Interaction Insight | Knowledge Interaction Insight |
| msdyn_knowledgemanagementsetting | Knowledge Management Setting | Setup knowledge management for your organization. |
| msdyn_knowledgepersonalfilter | Knowledge search personal filter config | Allows you to configure and manage personal filter settings. |
| msdyn_knowledgesearchfilter | Knowledge search filter | Allows you to configure and manage filter settings. |
| msdyn_knowledgesearchinsight | Knowledge Search Insight | Knowledge Search Insight |
| msdyn_mobileapp | Mobile App | Mobile App |
| msdyn_modulerundetail | Module Run Detail | Result of execution of a MEF model |
| msdyn_nonrelationalds | NonRelational Data Source | |
| msdyn_odatav4ds | OData v4 Data Source | Data sources used by the OData v4 data provider to access data from an external web service. |
| msdyn_pmanalysishistory | PM Analysis History | |
| msdyn_pmbusinessruleautomationconfig | PM Business Rule Automation Config | |
| msdyn_pmcalendar | PM Calendar | |
| msdyn_pmcalendarversion | PM Calendar Version | |
| msdyn_pminferredtask | PM Inferred Task | |
| msdyn_pmprocessextendedmetadataversion | PM Process Extended Metadata Version | |
| msdyn_pmprocesstemplate | PM Process Template | |
| msdyn_pmprocessusersettings | PM Process User Settings | |
| msdyn_pmprocessversion | PM Process Version | |
| msdyn_pmrecording | PM Recording | |
| msdyn_pmtemplate | PM Template | |
| msdyn_pmview | PM View | |
| msdyn_richtextfile | Rich Text Attachment | Image or file attached to a rich text field |
| msdyn_schedule | Schedule | Generic refresh schedule |
| msdyn_serviceconfiguration | Service Configuration | |
| msdyn_slakpi | SLA KPI | |
| msdyn_solutionhealthrule | Solution Health Rule | |
| msdyn_solutionhealthruleargument | Solution Health Rule Argument | |
| msdyn_solutionhealthruleset | Solution Health Rule Set | Represents a set that owns a number of solution health rules. |
| msdyn_timelinepin | Timeline Pin | Timeline Pin Record |
| msdyn_tour | Tour | |
| msdyn_virtualtablecolumncandidate | Virtual Table Column Candidate | |
| msdyn_workflowactionstatus | Workflow Action Status | PA Workflows action processing status |
| msdynce_botcontent | BotContent | |
| mspcat_catalogsubmissionfiles | Catalog Submission Files | Files associated with the package that will be used as part of the submission to the catalog system. |
| mspcat_packagestore | Package Submission Store | Manages submissions to the Catalog and provisioning |
| mspp_adplacement | Ad Placement | |
| mspp_columnpermission | Column Permission | |
| mspp_columnpermissionprofile | Column Permission Profile | |
| mspp_contentsnippet | Content Snippet | Content snippets are inserted in page templates so that any label, text string or image in the template can be content-managed. |
| mspp_entityform | Basic Form | Defines the form to render for a given entity type. |
| mspp_entityformmetadata | Basic Form Metadata | Defines the additional behavior modification logic to augment or override the functionality of form components that is not possible with Dynamics 365 entity and form metadata. |
| mspp_entitylist | List | |
| mspp_entitypermission | Table Permission | |
| mspp_pagetemplate | Page Template | URL of the .aspx page used to create new webpages. |
| mspp_pollplacement | Poll Placement | |
| mspp_powerpagescoreentityds | Power Pages Core Entity DS | |
| mspp_publishingstate | Publishing State | |
| mspp_publishingstatetransitionrule | Publishing State Transition Rule | |
| mspp_redirect | Redirect | |
| mspp_shortcut | Shortcut | |
| mspp_sitemarker | Site Marker | Used by web page templates to locate a specific page of content. |
| mspp_sitesetting | Site Setting | Site specific settings or variables refferenced by the web site code files. |
| mspp_webfile | Web File | Storage of files used in the web Portals. |
| mspp_webform | Multistep Form | Defines the necessary properties and relationships to the other key entities in order to control the initialization of the form within a web portal. |
| mspp_webformmetadata | Multistep Form Metadata | Defines the additional behavior modification logic to augment or override the functionality of form fields that is not possible with Dynamics 365 entity and form metadata. |
| mspp_webformstep | Form Step | Defines the flow logic of the form's user experience such as steps and conditional branching. |
| mspp_weblink | Web Link | A textual or imaged based link to an interal or external URL. |
| mspp_weblinkset | Web Link Set | A grouping of web links. |
| mspp_webpage | Web Page | Web Page |
| mspp_webpageaccesscontrolrule | Web Page Access Control Rule | |
| mspp_webrole | Web Role | Sets the user's role for the Portal. |
| mspp_website | Website | Web Portal |
| mspp_websiteaccess | Website Access | |
| mspp_websitelanguage | Website Language | Languages supported and publishing status for the portal |
| mspp_webtemplate | Web Template | |
| nlsqregistration | NL2SQ Registration Information | Org registration status, AllowedEntity list, and registration error message. |
| organizationdatasyncfnostate | OrganizationDataSyncFnoState | Information regarding data synchronization state |
| organizationdatasyncstate | OrganizationDataSyncState | Information regarding data synchronization state |
| organizationdatasyncsubscription | OrganizationDataSyncSubscription | |
| organizationdatasyncsubscriptionentity | OrganizationDataSyncSubscriptionEntity | |
| organizationdatasyncsubscriptionfnotable | OrganizationDataSyncSubscriptionFnoTable | |
| package | Package | |
| pluginpackage | Plugin Package | |
| powerbidataset | Power BI Dataset | |
| powerbidatasetapdx | powerbidatasetapdx | PowerBI Dataset appendix entity - for unmanaged technical attributes |
| powerbimashupparameter | Power BI Mashup Parameter | |
| powerbireport | Power BI Report | |
| powerbireportapdx | powerbireportapdx | PowerBI Report appendix entity for unmanaged technical attributes |
| powerfxrule | PowerfxRule | |
| powerpagecomponent | Site Component | |
| powerpagesite | Site | |
| powerpagesitelanguage | Site Language | |
| powerpagesitepublished | Power Pages Site Published | |
| processstageparameter | ProcessStageParameter | |
| provisionlanguageforuser | ProvisionLanguageForUser | |
| recentlyused | Recently Used | Most recently used data table. |
| recordfilter | Record Filter | Record Access Filter |
| recyclebinconfig | Recycle Bin Configuration | Holds recyclebin configuration for entities |
| retaineddataexcel | RetainedData Excel | A Place holder entity to save excel file for each exportretaineddata custom api requests. |
| retentionconfig | RetentionConfig | Holds retention policies for a table. |
| retentionfailuredetail | RetentionFailureDetail | Retention failure details. |
| retentionoperation | RetentionOperation | Retention policy execution details. |
| retentionoperationdetail | RetentionOperationDetail | Table level details of retention execution. |
| roleeditorlayout | RoleEditorLayout | |
| searchattributesettings | SearchAttributeSettings | |
| searchcustomanalyzer | SearchCustomAnalyzer | |
| searchrelationshipsettings | SearchRelationshipSettings | |
| searchtelemetry | Search Telemetry | Entity to log telemetry that used to improve search quality |
| sharedlinksetting | Shared Link Setting | Shared Link Setting |
| sharedworkspaceaccesstoken | Shared Workspace Access Token | Contains information about the shared workspace access tokens. |
| solutioncomponentattributeconfiguration | Solution Component Attribute Configuration | |
| solutioncomponentbatchconfiguration | Solution Component Batch Configuration | |
| solutioncomponentconfiguration | Solution Component Configuration | |
| solutioncomponentrelationshipconfiguration | Solution Component Relationship Configuration | |
| stagesolutionupload | StageSolutionUpload | |
| synapsedatabase | Synapse Database | This entity represents an external Synapse database and its associated datalake folder link. |
| synapselinkexternaltablestate | Synapse Link External Table State | Synapse Link external table states |
| synapselinkprofile | Synapse Link Profile | Synapse Link Profile |
| synapselinkprofileentity | Synapse Link Profile Entity | Entities associated with the Synapse Link profile |
| synapselinkprofileentitystate | Synapse Link Profile Entity State | Runtime state of the Synapse Link entity |
| synapselinkschedule | Synapse Link Schedule | Synapse link schedules |
| task | Task | Generic activity representing work needed to be done. |
| teammobileofflineprofilemembership | TeamMobileOfflineProfileMembership | |
| territory | Territory | Territory represents sales regions. |
| usermobileofflineprofilemembership | UserMobileOfflineProfileMembership | |
| userrating | User Rating | |
| virtualentitymetadata | Virtual Entity Metadata | Holds metadata values for virtual entities |
| workflowbinary | Workflow Binary | |
| workqueue | Work Queue | |
| workqueueitem | Work Queue Item |
Remarks
The following example shows using the CreateMultiple action with a table named sample_example.
Important
You must specify the @odata.type annotation with every item in the Targets parameter.
Request
POST [Organization Uri]/api/data/v9.2/sample_examples/Microsoft.Dynamics.CRM.CreateMultiple
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json
Content-Type: application/json; charset=utf-8
Content-Length: 396
{
"Targets": [
{
"sample_name": "sample record 0000001",
"@odata.type": "Microsoft.Dynamics.CRM.sample_example"
},
{
"sample_name": "sample record 0000002",
"@odata.type": "Microsoft.Dynamics.CRM.sample_example"
},
{
"sample_name": "sample record 0000003",
"@odata.type": "Microsoft.Dynamics.CRM.sample_example"
}
]
}
Response
HTTP/1.1 200 OK
OData-Version: 4.0
{
"@odata.context": "[Organization Uri]/api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.CreateMultipleResponse",
"Ids": [
"8f4c3f92-312b-ee11-bdf4-000d3a993550",
"904c3f92-312b-ee11-bdf4-000d3a993550",
"914c3f92-312b-ee11-bdf4-000d3a993550"
]
}
For more information see Bulk Operation messages.