![\"Web](\"https:\/\/www.inogic.com\/blog\/wp-content\/uploads\/2025\/05\/Web-API.png\")
<\/p>\n<\/p>\n
In this blog, we will walk through the process of creating a new segment in Real-Time Journeys and updating the segment by adding members using the Microsoft Dynamics 365 Web API. (Create a segment-based journey<\/a>)<\/p>\n A segment<\/strong> is a group of contacts or leads, either dynamically updated or statically defined, that you target in your real-time journey. It helps identify the audience for marketing activities such as emails, SMS, push notifications, and more.<\/p>\n While segments can be created manually through the UI, there are many cases where creating them programmatically using the Web API is far more powerful, especially for developers or integrated systems.<\/p>\n When a user triggers an event, you can instantly add contacts and leads to a specific segment using the Web API\u2014automatically, or you can create a new segment list with no manual intervention. This ensures that the right contacts are included in real-time journeys as soon as the event happens, streamlining the process and keeping everything up-to-date without any extra effort.<\/p>\n Entities Required for Segment Creation<\/strong><\/p>\n To create a static segment in Real-Time Journeys, you need to create records in the following two essential entities:<\/p>\n Please find below the steps to create a real-time segment:<\/strong><\/p>\n 1. Call the function:<\/strong> Call the ‘createSegment’ function with ‘recordIds’ as a parameter, where ‘recordIds’ contains the GUIDs of the records you want to add to the segments.<\/p>\n recordIds = “guid1”, “guid2”;\/\/ Replace with actual GUIDs<\/em><\/p>\n 2. Record creation:<\/strong> You have to create the 2 entities records i.e. Segment Definition,<\/strong> Segment <\/strong>entity<\/strong>.<\/strong><\/p>\n 3. Call Method:<\/strong> The \u2018WebApi.createRecord\u2019 method in Dynamics 365 is a client-side JavaScript function used to create new records in the Common Data Service (Dataverse). It is especially handy for dynamically generating records within model-driven apps using JavaScript.<\/p>\n 4. Final Output:<\/strong> After creation of the record successfully,<\/strong> the segment record will be created as shown in the screenshot below.<\/p>\n Example Account IDs: [ ” a0a59f03-1ebd-ef11-b8e8-6045bde7dfac, a0a59f03-1ebd-ef11-b8e8-6045bde7dfac”]\n Final Output: <\/strong>After updating the segment, the new members will be added to your existing segment as shown in the screenshot below:<\/p>\n By following these steps, users can effectively manage and utilize real-time marketing segments to drive targeted engagements and personalized campaigns within Microsoft Dynamics 365 CRM. This approach enhances audience segmentation, ensuring marketing efforts reach the right individuals at the right time.<\/p>\n","protected":false},"excerpt":{"rendered":" In this blog, we will walk through the process of creating a new segment in Real-Time Journeys and updating the segment by adding members using the Microsoft Dynamics 365 Web API. (Create a segment-based journey) A segment is a group of contacts or leads, either dynamically updated or statically defined, that you target in your\u2026 Read More »<\/a><\/span><\/p>\n","protected":false},"author":15,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"om_disable_all_campaigns":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[2361,65],"tags":[],"class_list":["post-41271","post","type-post","status-publish","format-standard","hentry","category-technical","category-webapi"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/posts\/41271","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/users\/15"}],"replies":[{"embeddable":true,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/comments?post=41271"}],"version-history":[{"count":0,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/posts\/41271\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/media?parent=41271"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/categories?post=41271"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/tags?post=41271"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\n
\n
\n
\n
createSegment(recordIds) {\r\n\r\nvar Seg: any = null\r\n\r\nvar ML: any = null;\r\n\r\ntry {\r\n\r\n\/\/Segments are used to define and organize target customer lists for marketing campaigns.\r\n\r\nML = new Object();\r\n\r\nML = {\r\n\r\n\"msdynmkt_name\": \"New Customers in Last 30 Days\",\r\n\r\n\"msdynmkt_includedmembers\": recordIds, \/\/Guid of the records\r\n\r\n\"statuscode\": 723270001, \/\/72327001-Live\r\n\r\n\"statecode\": 0, \/\/0 = Active, 1 = Inactive\r\n\r\n}\r\n\r\nXrm.WebApi.createRecord (\"msdynmkt_segmentdefinition\", ML).then(\r\n\r\nfunction success(result:any) {\r\n\r\n\/\/Segment definition record has been created successfully. We will now initiate the creation of a segment entity record.\r\n\r\nSeg = new Object();\r\n\r\nSeg = {\r\n\r\n\"msdynmkt_displayname\": \"New Customers in Last 30 Days\",\r\n\r\n\"msdynmkt_sourcesegmentuid\": result.id,\r\n\r\n\"msdynmkt_type\": 11,\/\/10 = Static segment 11 = Dynamic segment\r\n\r\n\"msdynmkt_source\": 12,\/\/12: Customer Insights - Journeys\r\n\r\n\"msdynmkt_membercount\": 3, \/\/length of the contact list\r\n\r\n\"msdynmkt_baseentitylogicalname\":\u201dcontact\u201d, \/\/Pass the entity type\r\n\r\n}\r\n\r\nXrm.WebApi.createRecord('msdynmkt_segment', Seg).then(\r\n\r\nfunction success(segResult:any) {\r\n\r\nif ((segResult.message != undefined)) {\r\n\r\n{\r\n\r\n\/\/Segment record has been created Successfully\r\n\r\nconsole.log(\"Segment Created Successfully\")\r\n\r\n}\r\n\r\n}\r\n\r\n\u00a0\r\n\r\n})\r\n\r\n},\r\n\r\nfunction (error:any) {\r\n\r\nconsole.log(\"Error: \" + error.message);\r\n\r\n}\r\n\r\n}\r\n\r\n);\r\n\r\ncatch (e: any) {\r\n\r\nconsole.log(e.message)\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 }\r\n\r\n}<\/pre>\n![\"Journeys](\"https:\/\/www.inogic.com\/blog\/wp-content\/uploads\/2025\/05\/2Journeys-Using-the-Web-API-1.png\")
Note: Currently, you can add only 100 members in the \u201cinclude members\u201d field of the segment.<\/strong> Update Segment:<\/strong> When working with Real-Time Marketing in Dynamics 365, you may need to update the “Include Members” field of a segment dynamically. Here\u2019s a refined approach to creating a real-time segment.<\/strong><\/p>\n\n
\n
\/\/On update button click you can call this button\r\nasync retrieveSegment( segmentdefinationId:any, selectedRecords:any){\r\n\r\nvar thisObj=this;\r\n\r\n\/\/ segmentdefinationId- Id of segment definition entity\r\n\r\n\/\/ selectedRecords- The record you wish to add in the include member for example a0a59f03-1ebd-ef11-b8e8-6045bde7dfac, a0a59f03-1ebd-ef11-b8e8-6045bde7dfac\r\n\r\nvar tempRecords:any= [];\r\n\r\nvar fetchXml = \"\";\r\n\r\nfetchXml = \"<fetch version='1.0' output-format='xml-platform' mapping='logical' distinct='false'>\" +\r\n\r\n\"<entity name='msdynmkt_segmentdefinition'>\" +\r\n\r\n\"<attribute name='msdynmkt_segmentdefinitionid' \/>\" +\r\n\r\n\"<attribute name='msdynmkt_name' \/>\" +\r\n\r\n\"<attribute name='msdynmkt_includedmembers' \/>\" +\r\n\r\n\"<attribute name='createdon' \/>\" +\r\n\r\n\"<order attribute='msdynmkt_name' descending='false' \/>\" +\r\n\r\n\"<filter type='and'>\" +\r\n\r\n\"<condition attribute='msdynmkt_segmentdefinitionid' operator='eq' uiname='New Segment'\u00a0\u00a0\u00a0 uitype='msdynmkt_segmentdefinition' value='\"+segmentdefinationId+\"'\/>\" +\r\n\r\n\"<\/filter>\" +\r\n\r\n\"<\/entity>\" +\r\n\r\n\"<\/fetch>\" ;\r\n\r\n\u00a0\r\n\r\nlet query: any = '?fetchXml=' + encodeURIComponent(fetchXml)\r\n\r\nawait Xrm.WebApi.retrieveMultipleRecords(\"msdynmkt_segmentdefinition\", query).then(function (results: any) {\r\n\r\n\u00a0\r\n\r\nvar members: any = results.entities[0].msdynmkt_includedmembers + \",\" + tempRecords;\r\n\r\nvar finalmembers = members;\r\n\r\nthisObj.updateSegment(finalmembers, results.entities[0].msdynmkt_segmentdefinitionid)\r\n\r\n},\r\n\r\nfunction(error:any){\r\n\r\nconsole.log(error.message)\r\n\r\n}\r\n\r\n)\r\n\r\n}\r\n\r\n\u00a0\r\n\r\n\/\/Update the segment\r\n\r\nasync updateSegment(response: any, segmentId: any) {\r\n\r\ntry {\r\n\r\nconst memberIds = {\r\n\r\n\"msdynmkt_includedmembers\": response \/\/ pass the Guids\r\n\r\n};\r\n\r\nawait Xrm.WebApi.updateRecord(\"msdynmkt_segmentdefinition\", segmentId, memberIds)\r\n\r\n.then(function (response: any) {\r\n\r\nconsole.log(\"Segment List Updated Successfully\")\r\n\r\n},\r\n\r\nfunction (error: any) {\r\n\r\nconsole.log(\"Error: \" + error.message);\r\n\r\n}\r\n\r\n)\r\n\r\n} catch (e: any) {\r\n\r\nconsole.log(e.message)\r\n\r\n}\r\n\r\n}<\/pre>\n![\"Journeys](\"https:\/\/www.inogic.com\/blog\/wp-content\/uploads\/2025\/05\/2Journeys-Using-the-Web-API.png\")
<\/p>\nConclusion<\/strong><\/h3>\n