{"id":31776,"date":"2022-10-28T11:02:37","date_gmt":"2022-10-28T04:02:37","guid":{"rendered":"https:\/\/docs.kirim.email\/?post_type=kb&#038;p=31776"},"modified":"2023-01-20T09:08:45","modified_gmt":"2023-01-20T02:08:45","slug":"how-to-automate-tagging-via-api","status":"publish","type":"kb","link":"https:\/\/docs.kirim.email\/en\/kb\/how-to-automate-tagging-via-api\/","title":{"rendered":"How to Automate Tagging via API"},"content":{"rendered":"\n<p>The purpose of this manual is to add tags automatically via the API.<\/p>\n\n\n\n<p>Simply put, you only need 2 steps to do this tagging, which include:&nbsp;<\/p>\n\n\n\n<ol><li>Create automation in the app, and<\/li><li>Send a request to the server.<\/li><\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Creating Automation in The App<\/h2>\n\n\n\n<p>First, you need to create an automation workflow in the application according to your needs. To do so, simply follow the steps below:<\/p>\n\n\n\n<ol><li>On the <strong>New Automation<\/strong> menu, select <strong>Custom Workflow<\/strong> to create an automation workflow from scratch.<br><br><a href=\"https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-01.png?ssl=1\"><img fetchpriority=\"high\" decoding=\"async\" width=\"863\" height=\"689\" class=\"wp-image-31830\" style=\"width: 640px;\" src=\"https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-01.png?resize=863%2C689&#038;ssl=1\" alt=\"\" srcset=\"https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-01.png?w=863&amp;ssl=1 863w, https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-01.png?resize=300%2C240&amp;ssl=1 300w, https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-01.png?resize=768%2C613&amp;ssl=1 768w\" sizes=\"(max-width: 863px) 100vw, 863px\" data-recalc-dims=\"1\" \/><\/a><br><br><\/li><li>For the first trigger, please select <strong>External Trigger<\/strong>.<br><br><a href=\"https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-02.png?ssl=1\"><img decoding=\"async\" width=\"1258\" height=\"934\" class=\"wp-image-31833\" style=\"width: 640px;\" src=\"https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-02.png?resize=1258%2C934&#038;ssl=1\" alt=\"\" srcset=\"https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-02.png?w=1258&amp;ssl=1 1258w, https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-02.png?resize=300%2C223&amp;ssl=1 300w, https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-02.png?resize=1024%2C760&amp;ssl=1 1024w, https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-02.png?resize=768%2C570&amp;ssl=1 768w\" sizes=\"(max-width: 1000px) 100vw, 1000px\" data-recalc-dims=\"1\" \/><\/a><br><br><br><\/li><li>After that, fill in all the available fields, including:<ol><li><strong>Name<\/strong> : Your automation name\/title<\/li><li><strong>Target List<\/strong> : List that\u2019ll be used to store data.<\/li><li><strong>Subscriber Field<\/strong> : Fields that\u2019ll be used to send data. The <strong>Email field must be included.<\/strong><\/li><li><strong>Action<\/strong> (<em>optional<\/em>) : Fill in with the action you want to perform.<br><strong>Notes: <\/strong>\u00a0You can use the External triggers for several functions. One of them is to check whether an order has been paid for or not.<br><br>For the implementation, you can fill in the <strong>Action<\/strong> field according to the function that\u2019ll be run on your platform.<br><br>For instance:<\/li><\/ol><\/li><\/ol>\n\n\n\n<ul><li><strong>action cart,<\/strong> to run the automation when the user checkout a product or something.<\/li><li><strong>action completed, <\/strong>to run the automation when the buyer has completed the payment.&nbsp;<\/li><\/ul>\n\n\n\n<p>These actions are defined by your platform. So you can leave this field blank if it\u2019s not needed.<br><\/p>\n\n\n\n<ol start=\"5\"><li>Next, copy the code provided in the <strong>How to Use<\/strong> section that\u2019ll be used to send requests to the server.<\/li><li>Click on the <strong>Save <\/strong>button.<br><a href=\"https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-03.png?ssl=1\"><img decoding=\"async\" width=\"1343\" height=\"964\" class=\"wp-image-31835\" style=\"width: 480px;\" src=\"https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-03.png?resize=1343%2C964&#038;ssl=1\" alt=\"\" srcset=\"https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-03.png?w=1343&amp;ssl=1 1343w, https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-03.png?resize=300%2C215&amp;ssl=1 300w, https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-03.png?resize=1024%2C735&amp;ssl=1 1024w, https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-03.png?resize=768%2C551&amp;ssl=1 768w\" sizes=\"(max-width: 1000px) 100vw, 1000px\" data-recalc-dims=\"1\" \/><\/a><br><br><\/li><\/ol>\n\n\n\n<ol start=\"4\"><li>After that, please select <strong>Add tag<\/strong> for the action.<br><br><a href=\"https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-04.png?ssl=1\"><img loading=\"lazy\" decoding=\"async\" width=\"494\" height=\"455\" class=\"wp-image-31839\" style=\"width: 480px;\" src=\"https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-04.png?resize=494%2C455&#038;ssl=1\" alt=\"\" srcset=\"https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-04.png?w=494&amp;ssl=1 494w, https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-04.png?resize=300%2C276&amp;ssl=1 300w\" sizes=\"(max-width: 494px) 100vw, 494px\" data-recalc-dims=\"1\" \/><\/a><br><\/li><li>Decide what tags will be added to the subscribers that join the list.<ol><li>If there is no tag, you can add it first by clicking on the <strong>+Add <\/strong>button.<\/li><li>Click on the <strong>Save <\/strong>button.<br><a href=\"https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-05.png?ssl=1\"><img loading=\"lazy\" decoding=\"async\" width=\"988\" height=\"674\" class=\"wp-image-31837\" style=\"width: 640px;\" src=\"https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-05.png?resize=988%2C674&#038;ssl=1\" alt=\"\" srcset=\"https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-05.png?w=988&amp;ssl=1 988w, https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-05.png?resize=300%2C205&amp;ssl=1 300w, https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-05.png?resize=768%2C524&amp;ssl=1 768w\" sizes=\"(max-width: 988px) 100vw, 988px\" data-recalc-dims=\"1\" \/><\/a><br><br><br><\/li><\/ol><\/li><li>Next, create a <strong>node\/workflow<\/strong> according to your needs.\u00a0<\/li><li>Click on the <strong>Save and Run<\/strong> button in the upper right corner of the page.<br><br><a href=\"https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-06.png?ssl=1\"><img loading=\"lazy\" decoding=\"async\" width=\"1425\" height=\"603\" class=\"wp-image-31841\" style=\"width: 480px;\" src=\"https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-06.png?resize=1425%2C603&#038;ssl=1\" alt=\"\" srcset=\"https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-06.png?w=1425&amp;ssl=1 1425w, https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-06.png?resize=300%2C127&amp;ssl=1 300w, https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-06.png?resize=1024%2C433&amp;ssl=1 1024w, https:\/\/i0.wp.com\/docs.kirim.email\/wp-content\/uploads\/2022\/10\/API-Tagging-Automation-06.png?resize=768%2C325&amp;ssl=1 768w\" sizes=\"(max-width: 1000px) 100vw, 1000px\" data-recalc-dims=\"1\" \/><\/a><br><br><br><\/li><li>Then, continue to <strong>send a request to the server<\/strong>.<\/li><\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Sending A Request to The Server<\/h2>\n\n\n\n<p>Lastly, please send a request to the server by giving the code you\u2019ve copied to the Developer Team in order to implement the automation into your platform.&nbsp;<\/p>\n\n\n\n<p>An example of the code is like this:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>curl &#8211;location &#8211;request POST &#8216;https:\/\/aplikasi.kirim.email\/automation&#8217; \\<br>&#8211;user &#8216;automation:4yvlYTwZ3cFQsU9AGIkTufAxqmE4vOAp&#8217; \\<br>&#8211;form &#8216;action:Cart&#8217; \\<br>&#8211;form &#8217;email=&#8221;EXAMPLE_DATA&#8221;&#8216; \\<br>&#8211;form &#8216;full_name=&#8221;EXAMPLE_DATA&#8221;&#8216; \\<br>&#8211;form &#8216;your_message=&#8221;EXAMPLE_DATA&#8221;&#8216; \\<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p><strong>Note :<\/strong> The code you get may be different from the example above. It depends on the automation store the system provides, the fields you use, and also the action.<\/p>\n\n\n\n<p>Finished.&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The purpose of this manual is to add tags automatically via the API. Simply put, you only need 2 steps to do this tagging, which [&hellip;]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-gradient":""}}},"kbtopic":[70],"kbtag":[],"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/docs.kirim.email\/en\/wp-json\/wp\/v2\/kb\/31776"}],"collection":[{"href":"https:\/\/docs.kirim.email\/en\/wp-json\/wp\/v2\/kb"}],"about":[{"href":"https:\/\/docs.kirim.email\/en\/wp-json\/wp\/v2\/types\/kb"}],"author":[{"embeddable":true,"href":"https:\/\/docs.kirim.email\/en\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.kirim.email\/en\/wp-json\/wp\/v2\/comments?post=31776"}],"version-history":[{"count":2,"href":"https:\/\/docs.kirim.email\/en\/wp-json\/wp\/v2\/kb\/31776\/revisions"}],"predecessor-version":[{"id":31844,"href":"https:\/\/docs.kirim.email\/en\/wp-json\/wp\/v2\/kb\/31776\/revisions\/31844"}],"wp:attachment":[{"href":"https:\/\/docs.kirim.email\/en\/wp-json\/wp\/v2\/media?parent=31776"}],"wp:term":[{"taxonomy":"kbtopic","embeddable":true,"href":"https:\/\/docs.kirim.email\/en\/wp-json\/wp\/v2\/kbtopic?post=31776"},{"taxonomy":"kbtag","embeddable":true,"href":"https:\/\/docs.kirim.email\/en\/wp-json\/wp\/v2\/kbtag?post=31776"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}