thumb-test.png

<h2>What is Automate?</h2>Automate is a user-friendly visual workflow builder designed for business users and developers. It empowers you to effortlessly create and manage complex, multi-step processes through intuitive clicks instead of delving into code. This simplification streamlines the integration of the Contentstack platform&nbsp;into your composable architecture, alleviating the associated technical complexities. <img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltf9681be1b6d35416/6625c430700d6cafe6a666b9/AH-image1.png" alt="AH-image1.png" height="auto"/>When someone opts for a headless CMS, they embrace the concept of "composing" a best-of-breed solution for themselves. Composability revolves around the idea of "plug-and-play," but not all competitors in the market offer true composability. This is where Automate sets itself apart.While other headless CMS competitors may provide some degree of automation, their automation is often limited to their CMS only.&nbsp;Contentstack's Automate extends its capabilities across the composable marketplace beyond the CMS.In other words, Automate is the first-ever automation solution that seamlessly integrates and functions across the composable stack! It empowers users to automate tasks within Contentstack's CMS and throughout their entire digital experience ecosystem. By leveraging Automate, users can create dynamic workflows while automating publishing, approvals, archiving, and other content operations without needing custom development. Its intuitive visual workflow builder and pre-built "recipes" enable users to streamline their content operations, regardless of technical expertise, efficiently.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt190acdddc8aac224/6625c4fb210d90d2483a3240/AH-image2.png" alt="AH-image2.png" height="auto"/><img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blta8ff7ac243b34016/6625c57424e1812b95acc90a/AH-image3.png" width="auto" alt="AH-image3.png" height="auto" max-width="auto" style="max-width: auto;width: auto;height: auto;"/><h2>Examples</h2><img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltf12e36182ffa4624/6625c5afc9de46bfffd472c6/AH-image4.png" alt="AH-image4.png" height="auto"/><h3>Example Use Cases:</h3>Content Enrichment: When content goes into a workflow stage, it executes an Automation to fetch information from external systems to write back to Contentstack. Rapid Prototyping: When you have an idea for a new process or concept, you can play around with it quickly in Automate by pointing and clicking to connect the APIs. Workflow Orchestration: With Automate, you can expand your content lifecycle to define events across the entire business process, not just inside Contentstack, such as marketing campaigns or newsletters.<h3> Simple Automation Script</h3>Let's say you have a blog website and want to automate the publishing process of new blog posts.&nbsp;Your workflow for Automate could look like this:<ol><li>Trigger:&nbsp;When a new entry is created in the "Blog" content type.</li><li>Condition:&nbsp;Check if the blog post's author is in an "Editor" role.</li><li>Action:&nbsp;If the condition is met, automatically set the "Status" of the blog post to "Review."</li><li>Notification:&nbsp;Send an email notification to the "Reviewers" group to review the new blog post.</li><li>Review and Approval:&nbsp;The reviewers can review the blog post, make any necessary changes, and approve it for publishing.</li><li>Action:&nbsp;If the blog post is approved, set the "Status" to "Published."</li><li>Action:&nbsp;If the blog post is rejected, set the "Status" to "Draft" and notify the author for revisions.</li></ol>With this workflow in place, whenever a new blog post is created, the Automate will automatically move the content through the different stages, notify the relevant users, and update the status based on the reviews and approvals.This automation can save time, reduce manual errors, and ensure a smooth content publishing process. Contentstack's Automate empowers users to design and implement customized workflows, tailoring them to meet their organization's specific content management requirements.Another example of an&nbsp;event&nbsp;is when a&nbsp;content entry&nbsp;is&nbsp;published&nbsp;or&nbsp;saved. When an&nbsp;event&nbsp;is triggered, we can use an&nbsp;Automate Connector&nbsp;to integrate with an external platform and perform an&nbsp;action&nbsp;using content from Contentstack. Pre-built&nbsp;Automate Connectors&nbsp;make setting up and configuring the integrations very easy. This course will show many examples of using these&nbsp;Automate Connectors&nbsp;to create integrations with search platforms, email systems, and commerce. <h3>Three reasons to use Automate</h3><ol><li>Integrate apps &amp; tools faster.Reduce integration time with an intuitive visual workflow builder that enables teams to connect Contentstack's CMS to the rest of the tools in their composable stack--all with clicks, not code.- Empower any user to create integrations with an easy-to-use visual editor - Execute complex actions defined by custom event triggers - Leverage pre-built “recipes” to get started quickly - Eliminate costly mistakes &amp; middleware</li><li>Eliminate the headache and costs associated with developing, hosting, and maintaining middleware by managing your integration solutions in one place.- Reduce complexity and increase efficiency by managing all your integrations in one centralized location. - Save money by removing the costs of hosting and managing middleware infrastructure. - Simplify your tech stack by eliminating the need for middleware development. - Streamline content &amp; development operations</li><li>Level up your content ops game and streamline content governance with advanced features that automate content workflows and provide greater visibility and control.- Automate publishing, approvals, archiving, and other content creation workflows. - Push content changes to all of your digital experience channels at once. - Assign advanced permissions and access controls for enterprise-level content governance.</li></ol>Automate ability to traverse the composable stack eliminates the need for costly middleware and offers unparalleled flexibility and efficiency. It opens up new possibilities for organizations to enhance their content operations, achieve faster time-to-market, and unlock the full potential of their digital experience stack.

What is Automate

<h2>Creating a Project in Automate</h2>
When you&nbsp;create a project&nbsp;in Automate within Contentstack, it means you are setting up a dedicated space to manage and execute your automation tasks.
By creating a project, you can automate various content-related tasks, reducing manual effort, improving efficiency, and ensuring consistency in your content management processes.
<h3>Steps to Create a 'New Project' in Automate</h3>1. Log in to your Contentstack account and navigate to the Automate section from the left navigation panel. <img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt29d01db612819a0b/6648ba4c16e6bf37bb590c44/automate-section.png" alt="automate-section.png" height="auto" />
 2. Click on the'New Project' button to create a new project.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt1a56786c25015b54/6648bb616d705597e74d9090/new-project.png" alt="new-project.png" height="auto" /> 3. This opens a dialog box where you can provide a name and description(as optional) for your project. This helps you identify and organize your automation tasks effectively. 4. Click on the&nbsp;'Create'&nbsp;button. 5. After successfully creating the project, you can start building an&nbsp;automation.
<h2>Creating an Automation</h2>Creating a&nbsp;new automation&nbsp;inside a project in Contentstack's Automate allows you to define and set up specific automated tasks or workflows to streamline your content management processes.&nbsp;It helps you set up specific steps that will be performed based on the specified conditions. Once you define these steps, Contentstack Automate will run through the designated steps.
1. Navigate inside the previous&nbsp;project that you created and click on the 'New Automation' button.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt55529f56aa4828f0/6648bc25d4d02e992a2eab6d/create-project.png" alt="create-project.png" height="auto" /> 2. This opens a dialog box where you can provide a name and description&nbsp;(optional) for your automation.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt5852cf6e9447a81d/6648bd9352619d711ea90a13/new-automation-dialog.png" alt="new-automation-dialog.png" height="auto" /> 3. Click on the&nbsp;'Create' button. 4. After successfully creating the automation, you can start configuring the trigger&nbsp;and action steps.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blte4704e39fdbc450e/6648bdef5fd9af818c70e24e/trigger-action-sterps.png" alt="trigger-action-sterps.png" height="auto" />

<h2>Limitations of Automate</h2>
<ul>
 <li>
 By default, each organization will be enrolled in the Explorer Plan, which is included at no cost and allows up to 200 executions per month (200 soft cap and 200 hard cap).
 </li>
 <li>
 The maximum number of&nbsp;projects&nbsp;allowed per organization is&nbsp;50.
 </li>
 <li>
 The maximum number of&nbsp;automations allowed per project&nbsp;is&nbsp;50.
 </li>
 <li>
 The maximum number of&nbsp;steps allowed per automation&nbsp;is&nbsp;15.
 </li>
 <li>
 The&nbsp;maximum number of loops per Repeat Path is 100.
 </li>
 <li>
 Currently, organization members can only view and edit their own projects.
 </li>
 <li>
 Currently, organization members can only view and edit their own projects.
 </li>
 <li>
 There is no support for nesting within Conditional Path and Repeat Path steps.
 </li>
 <li>
 The Pause and Response action connectors cannot be used within Conditional Path and Repeat Path steps.
 </li>
 <li>
 Automate is a plan-based feature, and the number of executions allowed depends upon the Automate pricing plan that is activated for a particular organization.
 </li>
 <li>
 Organizations that have upgraded to a paid plan will have a soft cap for executions (when reaching this threshold they will be notified by email), and a hard cap that is 5x the number of the soft cap. After the organization hits the hard cap, automations will be temporarily disabled for that month.
 </li>
</ul>
<h2>Further Reading</h2>
<ul>
 <li>
 <a href="https://www.contentstack.com/docs/developers/automation-hub-guides/create-an-automation/">More about 'Create a New Automation'</a>
 </li>
 <li>
 
 <div><a href="https://www.contentstack.com/docs/developers/automation-hub-guides/edit-automation-details/">Edit an existing Automation</a></div>
 
 </li>
 <li>
 
 <div><a href="https://www.contentstack.com/docs/developers/automation-hub-guides/delete-automation/">Delete an existing Automation</a></div>
 
 </li>
 <li>
 
 <div><a href="https://www.contentstack.com/docs/developers/automation-hub-guides/limitations-of-automation-hub">Automate Limitations - Review maximum number of projects, automations and steps</a></div>
 
 </li>
</ul>

Creating a New Project

First Automate Project Walkthrough

Ah-first Ah Project

<h1>Exercise Review: Your First Automation Hub Project</h1>1. The Automation Hub Project contains one or more automations. The configuration settings and authorizations are shared within an Automation Hub project.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltdfe3ff2a3c263cbe/6648c1205c24835191bc345b/er-create-automation.png" alt="er-create-automation.png" height="auto"/>2.&nbsp;The Contentstack Trigger Connector allows us to listen and react to events occurring within the Contentstack UI. For example, the publish entry or save entry events.&nbsp;<img asset_uid="blt84323b82694e0c34" src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt84323b82694e0c34/6648c1a5d4d02eecc82eab76/config-trigger.png" alt="config-trigger.png" height="auto"/><img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt66a6986f45bfa9df/6648c202acadaf48b07282dc/trigger-types.png" alt="trigger-types.png" height="auto"/>3. The Action step receives the JSON from the Entry in the event and can access the properties of the Entry. &nbsp;<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt7209e595367da050/6648c24e0b508a7d34dcfc62/test-trigger.png" alt="test-trigger.png" height="auto"/><img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltd7d3aaaee993018a/6648c2613092d0864a63f98d/test-trigger2.png" alt="test-trigger2.png" height="auto"/>4. Access the content fields of the Entry using the 'body.data.entry' property in the Body of the email. Other connectors allow similar access to the Entry content in the Action step.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt07960e4f683f1151/6648c2c24ac76e5e0740f842/email-automate.png" alt="email-automate.png" height="auto"/>

Exercise Review: Your First Automation Hub Project

Settings & Options

Ah-overview-settings

<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt13fb0843f8d32f85/6648dc36dda14b1dbfdff5d7/types-of-triggers.png" alt="types-of-triggers.png" height="auto"/>In Contentstack,&nbsp;Triggers are conditions or invocation points that begin, or "fire off", an Automation when an event occurs.&nbsp; Events supported include: actions within Contentstack such as a Save or Publish event,&nbsp; scheduled event, receiving a webhook call from an external platform, or deploying an app with the Contentstack Launch product.&nbsp; Triggers and events help automate a business workflow to accomplish required tasks.In the real world,&nbsp;Triggers are like sensors or switches that detect specific events or conditions and initiate a series of actions or workflows in response. They act as the starting point for automation, signaling when something specific happens and prompting the system to perform predefined tasks.<h2>What are Triggers?</h2><ul><li>First, let's look at an analogy.&nbsp; Imagine a scenario with a high-tech security system installed in your house. This system includes motion sensors, door sensors, and cameras, all connected to a central control panel. These are all "triggers" that wait for motion. Then, they send a signal with information about the motion (photo / time / device ID) to the control panel, which serves as the hub for automation and security.&nbsp; After the hub receives the trigger notification, it can perform a series of actions customized by the type of information received - for example, play a small sound for a door sensor or send a video to the cloud for a camera sensor.</li><li>In this scenario, triggers in the Automation Hub can be compared to the various sensors placed throughout your house. When a trigger event occurs, such as a motion sensor detecting movement or a door sensor detecting an unauthorized entry, it sends a signal to the central control panel.</li><li>For instance, if a trigger event is defined to activate when a new article is published, it will automatically initiate a series of actions like sharing the article on social media platforms, sending notifications to subscribers, or updating relevant databases. The trigger serves as the starting point for these actions, ensuring that the appropriate automation processes are set in motion based on the defined events.</li></ul>Triggers in Automation Hub detect specific events or conditions within Contentstack. These events can range from content publishing, content updates,&nbsp; API calls, or scheduled time intervals. When a trigger event occurs, it activates the automation workflow associated with it.<h2>Types of Connection Triggers</h2><img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt973d0a0974d50e66/6648dc9f0bbc6203ad7fabbf/types-of-triggers.png" alt="types-of-triggers.png" height="auto"/><ol><li>Contentstack:&nbsp;This connector allows you to create triggers based on content-related events, such as creation, update, publish, or delete actions within Contentstack itself.</li><li>HTTP:&nbsp;The HTTP connector allows you to create triggers based on incoming HTTP requests from external services or applications. You can configure webhooks or receive notifications from external systems.</li><li>Launch:&nbsp;The Launch connector enables you to create triggers based on events within Contentstack's Launch environment. The launch is a product by Contentstack that provides a robust way to manage and deliver content to various digital channels.</li><li>Scheduler:&nbsp;The Scheduler connector enables you to create triggers based on a predefined schedule or time interval. You can set up triggers to execute actions at specific times or recurring intervals.</li></ol>Each connector provides specific functionalities to trigger actions based on different events or conditions within Contentstack or external systems. We will explore them in detail very soon.

Understanding Triggers

Using Trigger Connectors

Ah-trigger Connectors

<h1>Understanding Connectors&nbsp;</h1>Connectors in Automation Hub understand different systems' specific requirements and capabilities, whether content management systems, marketing automation platforms, or third-party services.<h2>What are Connectors?</h2>Connectors&nbsp;are like bridges that connect different systems and enable smooth communication and data flow between them. They act as intermediary components that facilitate the exchange of information, triggering actions, and automating processes.<h2>Example</h2><ul><li>Imagine you have a large city with multiple transportation systems like roads, railways, and airports. Each system operates independently and has its own unique functions and rules. However, for efficient transportation and logistics, you need a way to connect these systems and enable the smooth movement of people and goods.</li><li>In this scenario, connectors in the Automation Hub are like well-designed interchanges, terminals, and transfer points that ensure a seamless flow of traffic between the different transportation systems. They understand the needs and protocols of each system and provide a standardized interface for the vehicles to enter, exit, and transfer between them.</li></ul>

Using Connectors

Action Connectors

Ah-action Connectors

<h2>Automate Connectors</h2>Automation Hub&nbsp;connectors&nbsp;are third-party applications that you can use with Automation Hub to automate certain tasks. Here are a few connectors you can set up quickly and use in an automation.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt450a11a187293158/6648df3f015b1c5aaa56ef88/automate-connectors.png" alt="automate-connectors.png" height="auto"/>Here are some examples of actions you can perform in Contentstack's Automation Hub:<ul><li>Update Content:&nbsp;Imagine you have a library, and when new books arrive, your librarian automatically updates the catalog with the book's information, including its title, author, and genre. Similarly, the "Update Content" action in Contentstack automatically modifies specific fields or attributes of a content entry when triggered.</li></ul> <img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltd5d421643619410c/6648dfa60a0de6ffe5314ce9/update-entry.png" alt="update-entry.png" height="auto"/>Publish Content:&nbsp;Think of a newspaper editor who, upon finalizing an article, presses a button to send it for printing and distribution to the subscribers. In Contentstack, when triggered, the "Contentstack Action - Publish Content" automatically publishes content to your website, mobile app, or any other digital channels.&nbsp; For example, the Trigger may be Entry Update, so every time an Entry is saved. the Automation Hub re-publishes the content to an 'Instant Preview' frontend site.&nbsp;<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt3fb4550b9d2c404f/6648dfe34ac76e417540f869/publish-entry.png" alt="publish-entry.png" height="auto"/>Notify Team:&nbsp;Consider a fire alarm system in a building that detects smoke or fire and immediately alerts the building occupants with loud sirens and flashing lights. Similarly, the "Email by Automation Hub" and "Slack" actions in Automation Hub send notifications or alerts to designated team members, such as sending an email or a message in a collaboration tool like Slack, when a trigger event is detected.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt01249a627ac710d3/6648e00d0a0de65c88314ced/communicate.png" alt="communicate.png" height="auto"/>Create Task:&nbsp;Picture a project manager who wants to create a Jira task when an item is assigned in Workflow.&nbsp; When an Entry is set to a workflow stage in Contentstack, an Automation is triggered to create a new Jira task.&nbsp; In Contentstack, when triggered, the&nbsp;<a href="https://www.contentstack.com/docs/developers/automation-hub-connectors/jira/">"JIRA" action</a>&nbsp;generates new tasks or assigns tasks to team members in Jira and works together with the content workflow.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt472505ba83ebeb1f/6648e04916e6bf7142590c5b/choose-connector.png" alt="choose-connector.png" height="auto"/><img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt2bd9a0b07a06bf3b/6648e0674284321e941989a0/connector-detail.png" alt="connector-detail.png" height="auto"/>

Automate Connectors

<h2>Types of Action Connectors</h2>In Contentstack's Automation Hub, several types of action connectors are available. These action connectors allow you to define specific tasks or operations to be executed when a trigger event occurs.&nbsp; &nbsp;Each connector represents a specific integration or service that can perform actions in your automation workflows.Each connector receives JSON from the previous steps and can use a&nbsp;<a href="https://www.contentstack.com/docs/developers/automation-hub-connectors/transform">Transform connector</a>&nbsp;to massage or directly consume the data. If you want to connect to a service not listed here, then the&nbsp;<a href="https://www.contentstack.com/docs/developers/automation-hub-connectors/http-action">HTTP Action</a>&nbsp;can send JSON to any 3rd-party web service.<a href="https://www.contentstack.com/docs/developers/automation-hub-connectors">Here are the types of action connectors in Contentstack's Automation Hub</a>:<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt61d6e1debdf89919/6648e12516e6bf4543590c61/types-of-connectors.png" alt="types-of-connectors.png" height="auto"/><ol><li>CMS:<ul><li>Contentstack Action:&nbsp;Performs content-related actions such as&nbsp;'Get All Content Types,' 'Get All Entries,' 'Delete an Entry,' 'Add Items to a Release,' 'Clone a Release,' 'Create a Release,' 'Delete Items from a Release,' 'Deploy a Release,' 'Get All Items in a Release,' 'Get All Releases,' 'Get Single Release,' 'Get User Information,' 'Create an Entry,' 'Entry Workflow Stage,' 'Localize an Entry,' 'Publish an Entry,' 'Publish an Asset,' 'Unpublish an Entry,' 'Get Single Entry,' 'Update Entry.'</li></ul></li><li>CI/CD Platform:<ul><li>CircleCI,&nbsp;TravisCI:&nbsp;Integrates with CircleCI, TravisCI for continuous integration and delivery workflows.</li></ul></li><li>Communication:<ul><li>Email by Automation Hub:&nbsp;Sends emails as an action within Contentstack's Automation Hub.</li><li>Mailgun:&nbsp;Integrates with the Mailgun email service for sending emails.</li><li>PubNub:&nbsp;Integrates with the PubNub platform for real-time messaging and communication.</li><li>Pusher:&nbsp;Integrates with Pusher for real-time push notifications.</li><li>SendGrid:&nbsp;Integrates with SendGrid for sending emails.</li><li>Slack:&nbsp;Sends messages or notifications to Slack channels or users.</li><li>Twilio:&nbsp;Integrates with Twilio for SMS and voice communication.</li></ul></li><li>Artificial Intelligence:<ul><li>ChatGPT:&nbsp;Uses OpenAI's ChatGPT for AI-powered chatbot capabilities.</li></ul></li><li>Digital Asset Management:<ul><li>Cloudinary:&nbsp;Integrates with Cloudinary for digital asset management and manipulation.</li><li>Aprimo:&nbsp;Integrates with Aprimo's digital asset management platform.</li></ul></li><li>eCommerce:<ul><li>BigCommerce:&nbsp;Integrates with the BigCommerce eCommerce platform.</li></ul></li><li>FaaS (Function-as-a-Service):<ul><li>AWS Lambda:&nbsp;Executes serverless functions on the AWS Lambda platform.</li></ul></li><li>Hosting:<ul><li>Launch:&nbsp;Performs actions within Contentstack's Launch environment.</li><li>Heroku:&nbsp;Integrates with Heroku for application hosting and deployment.</li><li>Netlify:&nbsp;Integrates with Netlify for static website hosting and deployment.</li><li>Vercel:&nbsp;Integrates with Vercel for static website hosting and deployment.</li></ul></li><li>Development:<ul><li>Code Block:&nbsp;Executes custom code or scripts as an action within Contentstack's Automation Hub.</li></ul></li><li>Database:<ul><li>Airtable:&nbsp;Integrates with Airtable, a collaborative database and project management tool.</li></ul></li><li>Messaging Queue:<ul><li>AWS SQS:&nbsp;Integrates with AWS Simple Queue Service for messaging and queuing capabilities.</li></ul></li><li>Notification Service:<ul><li>AWS SNS:&nbsp;Integrates with AWS Simple Notification Service for sending notifications to various endpoints.</li></ul></li><li>Project Management:<ul><li>Jira:&nbsp;Integrates with the Jira project management tool.</li></ul></li><li>Translation Platform:<ul><li>Smartling:&nbsp;Integrates with Smartling, a translation management platform.</li></ul></li><li>Search &amp; Discovery:<ul><li>Algolia:&nbsp;Integrates with Algolia for search and discovery capabilities.</li><li>Constructor:&nbsp;Integrates with Constructor for site search and search analytics.</li><li>Elasticsearch:&nbsp;Integrates with Elasticsearch for powerful search and indexing capabilities.</li></ul></li><li>Storage:<ul><li>AWS S3:&nbsp;Integrates with AWS Simple Storage Service for storing and retrieving files and objects.</li></ul></li><li>Storage:<ul><li>AWS S3:&nbsp;Integrates with AWS Simple Storage Service for storing and retrieving files and objects.</li></ul></li><li>Utility:<ul><li>Data Store:&nbsp;This helps you store keys and their corresponding values within a database that you can retrieve later. With the Data Store connector, you can also store and fetch the data stored during execution.</li><li>HTTP Action:&nbsp;This enables you to perform HTTP requests as an action within Contentstack's Automation Hub. You can send HTTP GET, POST, PUT, DELETE, or PATCH requests. This connector is valuable for integrating with external systems or triggering actions in other applications.</li><li>Pause:&nbsp;This lets you pause existing automation.</li><li>Transform:&nbsp;Helps in manipulating texts and numbers as required. It helps you to manipulate and structure data according to your needs. For example, suppose in the previous trigger; specific data is selected to be displayed. In that case, the action defined by the Transform connector can manipulate or change to meet your display requirements.</li><li>Response:&nbsp;Helps determine the status of your configured action. It notifies users about the success or failure of a configured action with a response.</li><li>RTE Formatter:&nbsp;Helps convert content within the JSON Rich Text Editor into HTML or text formats.</li><li>Utility:&nbsp;Helps to manage your automation workflow. With the wait action, you can put your automation on hold for some time before the following automation action runs. </li></ul></li></ol>

Types of Action Connectors

Automations in Marketplace

Ah-automations-in-marketplace

Using Trigger Conditions to Control an Automate Execution

Ah-trigger Conditions

Using Conditionals When Publishing to Production

Ah-conditionals With Email Notification

Using the HTTP Connector with a Publish Event

Ah-http Listener

Using HTTP Listeners

<h1>HTTP Listener</h1>The&nbsp;HTTP Listener&nbsp;connector allows you to create automated workflows to&nbsp;receive incoming HTTP requests&nbsp;and trigger specific actions based on the received data. This endpoint listens to incoming HTTP requests and processes them according to your workflow.&nbsp; An HTTP endpoint is provided that an external platform or external webhook can use and send JSON data to Automation Hub.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt8c471a1cdcd30f3e/664947c35c248385cfbc34f9/http-listener2.png" alt="http-listener2.png" height="auto"/><h2>Example</h2>Here's an example to illustrate the use of the HTTP Listener connector:Let's say you have an e-commerce website, and you want to trigger an automation workflow whenever a new order is received through an API call.<ol><li>Set up the HTTP connector&nbsp;-<ul><li>In Automation Hub, select the "HTTP" connector.</li></ul></li><li>Configure the HTTP trigger -<ul><li>Configure the HTTP method (e.g., POST) trigger&nbsp;and define any required authentication or headers.</li><li>Define the specific endpoint or route corresponding to the URL generated for the order creation API call.</li><li>Set any required headers or parameters to match your API requirements.</li></ul></li><li>Define subsequent actions -<ul><li>Once the HTTP connector trigger receives the HTTP request, you can define subsequent actions in the workflow.</li><li>Add actions such as validating the order, updating inventory, sending confirmation emails, or integrating with other systems.</li></ul></li><li>Test and deploy the workflow -<ul><li>Test the workflow by simulating an API call to the defined endpoint and verifying that the trigger is activated.</li><li>Ensure that the subsequent actions in the workflow, such as order processing and system integration, are executed as expected.</li><li>Once tested, activate the workflow and&nbsp;be ready to process incoming API requests.</li></ul></li></ol>In this example, the HTTP connector acts as a trigger, allowing you to listen for incoming API calls and initiate the defined automation workflow. You can perform various actions within the workflow based on the received order data, such as updating databases, triggering notifications, or performing business logic.Using the HTTP connector as a trigger provides flexibility in integrating external systems or services with Contentstack's Automation Hub. You can easily automate processes, streamline data flows, and orchestrate complex workflows by leveraging the HTTP connector's ability to listen for incoming HTTP requests.

Understanding HTTP Listeners

<h1>Scheduled Jobs</h1>The&nbsp;Scheduler by Automate&nbsp;connector in Contentstack allows you to schedule and automate tasks or workflows at specific times or intervals. It acts as a trigger to initiate an automation workflow based on the defined schedule.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt63e0fdbddb2882fe/66494833342fb531a162ccc5/scheduled-jobs.png" alt="scheduled-jobs.png" height="auto"/>Let's consider a scenario where you want to send a daily email newsletter to your subscribers at a specific time using Contentstack's Automate:<ol><li>Set up the 'Scheduler by Automate' connector and trigger -<ul><li>In Automation Hub, select the 'Scheduler By Automate' connector.</li><li>Configure the scheduler trigger by specifying the Time Zone and Unix Cron Pattern.&nbsp;Specify the exact time or interval you want the automation workflow to be triggered.</li></ul></li><li>Define subsequent actions -<ul><li>Once the scheduler trigger activates the workflow, you can define subsequent actions.</li><li>Add actions to generate the email newsletter content, fetch subscriber data, and send personalized emails.</li></ul></li><li>Test and deploy the workflow -<ul><li>Test the workflow by manually triggering it or waiting for the scheduled time.</li><li>Verify that the workflow executes as expected, generating and sending the email newsletters to subscribers.</li><li>Once tested, activate the workflow and&nbsp;automate the daily email newsletter process.</li></ul></li></ol>In this example, the Scheduler by Automation acts as a trigger, allowing you to schedule the execution of a workflow at specific times or intervals. The automation workflow can perform various actions, such as generating dynamic content, fetching data from external sources, and sending emails to subscribers.Using Scheduler by Automation, you can streamline recurring tasks, automate time-based processes, and ensure consistent and timely execution of workflows within Contentstack's Automate.

Understanding Scheduler by Automate

<h1>Launch Connector</h1>The&nbsp;Launch&nbsp;connector&nbsp;is a feature that allows you to initiate deployments of websites hosted on the Contentstack-powered jamstack platform called "Launch." Whether your website's content is managed by a different CMS (headless or traditional), you can use Launch to quickly host such sites.&nbsp;You can easily trigger deployments by creating a new project in Launch and connecting it to your GitHub or GitLab repository. This seamless integration streamlines the deployment process for your websites, making it efficient and hassle-free.<h2>Launch Connector for Action</h2><img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltdda2557e6e507603/66494908efc97a69cb4c0ac4/launch-connector.png" alt="launch-connector.png" height="auto"/>Let's consider an example where&nbsp;the team sets up a scheduled job to automatically deploy new code builds for your website at midnight every Sunday by&nbsp;using the Scheduled Jobs Trigger with Launch Action Connector:<ol><li>Set up the 'Scheduler by Automate' connector and trigger -<ul><li>In Automate, select the 'Scheduler By Automate' connector.</li><li>Configure the scheduler trigger by specifying the Time Zone and Unix Cron Pattern.&nbsp;Specify the exact time or interval you want the automation workflow to be triggered. Here, at midnight every Sunday.</li></ul></li><li>Define 'Launch Connector' action&nbsp;-<ul><li>Once the scheduler trigger activates the workflow, you define the Launch connector in the action.</li><li>This action deploys the build for the authorized and selected Launch project.</li></ul></li><li>Test and deploy the workflow -<ul><li>Test the workflow by manually triggering it or waiting for the scheduled time.</li><li>Verify that the workflow executes as expected, deploying the build to the set environment.</li><li>Once tested, activate the workflow&nbsp;and automate your website build deployment.</li></ul></li></ol>This approach proves beneficial as the team can confidently plan and execute updates without disrupting the website's live performance.<h2>Launch Connector for Trigger</h2><img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt1d6b0a82057555c3/664949670b508aef4fdcfd1e/launch-connector-for-trigger.png" alt="launch-connector-for-trigger.png" height="auto"/>Let's consider an example where we set up 'Launch as the trigger' for the automation. Whenever a deployment on Launch fails, the automation automatically sends an email notification to a designated group of users using the 'Email by Automate' action connector:<ol><li>Set up the 'Launch' connector and trigger -<ul><li>In Automate, select the 'Launch' connector.</li><li>Configure the 'Deployment' trigger where you select the event as&nbsp;'Deployment&nbsp;failed'&nbsp;for the selected Launch project.</li></ul></li><li>Define 'Email by Automate' action&nbsp;-<ul><li>Once the scheduler trigger activates the workflow, you define the 'Email by Automate' connector in the action.</li><li>This action will email the list of users(specified during the setup) when the Launch deployment fails.</li></ul></li><li>Test and deploy the workflow -<ul><li>Test the workflow by manually triggering it or deploying the Launch project.</li><li>Verify that the workflow executes as expected, deploying the build to the set environment.</li><li>Once tested, activate the workflow&nbsp;and automate your website build deployment status.</li></ul></li></ol>This example demonstrates how Automate can be used to proactively notify the team about deployment issues, allowing them to address and resolve any potential challenges promptly.

Launch Connector

<h2>Data Store Connector</h2>The Data Store connector in Automate provides a convenient way to store key-value pairs within the Contentstack database. These key-value pairs can be used to store any data you want to retrieve and use later in your automation workflows. The Data Store connector allows you to store data during the execution of automation and fetch it when needed.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt93f2a8b94bd49abf/66494a0f4ac76e5d8f40f8fc/data-store.png" alt="data-store.png" height="auto"/>Key Features of the Data Store Connector:<ol><li>Data Storage -&nbsp;The Data Store connector can store data as key-value pairs. Each pair consists of a unique key and its corresponding value. The data stored can be of any type, including strings, numbers, booleans, and even complex data structures like objects or arrays.</li><li>Data Retrieval -&nbsp;Once data is stored using the Data Store connector, you can retrieve it later within the same automation or across different workflow steps. This lets you pass data between different actions and conditions, making your automation more dynamic and versatile.</li><li>Persistent Storage -&nbsp;The data stored using the Data Store connector is persistently saved within the database. This means that even if the automation execution is paused or stopped, the data will still be available when the execution resumes.</li><li>Instance-Specific Data -&nbsp;The Data Store connector allows you to store and fetch data specific to the current instance of an automation execution. This enables you to manage data at the instance level and avoids conflicts or data interference between different executions of the same automation.</li></ol>Use Cases of the Data Store Connector:<ol><li>Configuration Management -&nbsp;You can use the Data Store connector to store configuration settings, such as API keys, credentials, or connection details, that need to be accessed by multiple actions or steps within automation.</li><li>Data Transfer and Transformation -&nbsp;The Data Store connector can transfer data between different automation steps. For example, you can store data in one step and fetch it later to perform transformations or calculations in subsequent steps.</li><li>State Management -&nbsp;If your automation involves multiple conditional branches or loops, the Data Store connector can help manage the automation's state by storing and updating relevant data as the automation progresses.</li><li>Error Handling and Recovery -&nbsp;The Data Store connector can store error messages or status flags during the execution of automation. This can aid in error handling and recovery strategies.</li></ol>In summary, the Data Store connector in Automate provides a flexible and efficient way to store and retrieve data within your automation workflows. It enables you to create more sophisticated and data-driven automations, enhancing efficiency and productivity in your processes.<h1>HTTP Action Connector</h1>An HTTP action connector is a utility connector that interacts with external services, APIs, or web endpoints using the Hypertext Transfer Protocol (HTTP). You can send HTTP requests (such as GET, POST, PUT, DELETE) to remote servers, receive responses, and potentially process or transform the data through this connector.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltf8395252dca738e0/66494a5b0bbc628ea47fac08/http-connector.png" alt="http-connector.png" height="auto"/>Key Features of an HTTP Action Connector:<ul><li>HTTP Methods -&nbsp;Supports various HTTP methods like GET, POST, PUT, and DELETE, allowing you to interact with different parts of an API.</li><li>Request Configuration -&nbsp;You can configure headers, query parameters, request body, and other settings required for the API request.</li><li>Response Handling -&nbsp;Typically, you can extract data from the response, handle status codes, and parse the returned data (often in JSON or XML format).</li><li>Authentication -&nbsp;Supports various authentication mechanisms, such as API keys, OAuth tokens, or basic authentication.</li><li>Error Handling -&nbsp;Provides options to handle errors, retries, and timeouts to ensure robust interactions with the API.</li><li>Customization -&nbsp;Allows you to customize and manipulate the data before sending the request or after receiving the response.</li></ul>Use Cases for HTTP Action Connectors in Utility Connectors:<ol><li>Data Integration -&nbsp;You can use the HTTP action connector to fetch data from external sources like APIs and synchronize it with your Contentstack content. For example, automatically pulling data from a third-party system and updating content entries.</li><li>Third-Party Services -&nbsp;Integrate with third-party services like email platforms, messaging services, or social media APIs to trigger actions based on content changes.</li><li>Content Enrichment -&nbsp;Utilize external services to enrich your content. For instance, automatically tagging content with relevant keywords using a natural language processing API.</li><li>Webhooks: Receive and process data from external sources through webhooks. The HTTP action connector can parse and handle incoming webhook payloads.</li><li>Content Delivery: Trigger HTTP requests to deliver content to external systems. This could involve publishing content to a website or an external database.</li><li>Data Migration: Use the HTTP action connector to migrate content from one system to another by sending appropriately formatted API requests.</li></ol>In summary, An HTTP action connector is a tool in workflow automation platforms that lets you interact with external services via HTTP requests. In Contentstack Automate, it can help integrate data, trigger actions based on content changes, enrich content, manage webhooks, deliver content, and handle data migration.<h1>Utility Connector - Wait Action</h1>The Utility action connector helps to manage your automation workflow. With the wait action, you can put your automation on hold for some time before the following automation action runs.You can set up three actions: Wait, Continue Automation If, and Continue Repeat If.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt1902cd2c8600e1b4/66494ade0bbc6207ac7fac0c/wait-action1.png" alt="wait-action1.png" height="auto"/><h2>Example: Wait connector in Repeat Path</h2>Let’s see a simple use-case of the Utility connector using Repeat Path.Wait action is useful while working with bulk data. Previously, if the number of API requests exceeded the defined limitation, the automation failed automatically due to rate limiting.In this example, we are sending bulk data through the HTTP action with a limitation of 5 API requests per second, and we will use the Wait action to delay the API request per second to create multiple entries in Contentstack. We will also see how the user receives an error message in the Execution Log section for exceeding the rate limit.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltd87d2c9ea470f3bc/66494b00b2e852f9f0451976/wait-action2.png" alt="wait-action2.png" height="auto"/>For examples of every Utility option, please see the&nbsp;<a href="https://www.contentstack.com/docs/developers/automation-hub-connectors/utility" target="_self">Automate Utility documentation</a>.<h2>Transform</h2>Transform does exactly what it sounds like - transforming data from one format to another. More specifically, it allows the developer to specify the JSON format that will be passed to a future Automation step and use the data and properties from Entries or other objects and properties available.For example, our external system expects a JSON object with a title, content property, and date. Using Transform, we can create a new JSON object with only 3 properties and fill in the data from Contentstack objects in the Automation.In the screenshot below, we are creating a new JSON object with a property called 'result' containing the value of the Entry's name field capitalized.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt0b5daaf2141713c8/66494b574b531e4547c328ba/transform2.png" alt="transform2.png" height="auto"/><img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt8d241b3597b12963/66494b57015b1c360b56effa/transform1.png" alt="transform1.png" height="auto"/>

Utility Connectors

Use Case: Translation with ChatGPT

Ah-chatgpt Translations Example

Automate is a user-friendly visual workflow builder designed for business users and developers. It empowers you to effortlessly create and manage complex, multi-step processes through intuitive clicks instead of delving into code. This simplification streamlines the integration of the Contentstack platform&nbsp;into your composable architecture, alleviating the associated technical complexities.Pre-requisites: 1. Account in Contentstack with access to a Stack as an Administrator or Developer. If possible, please create a new Stack to use only with the Partner Courses.2. A basic comprehension of the Contentstack platform, extensions, and integrations.3. Comfortable taking a screenshot or a movie of your screen. The free browser tool 'Loom' is one of many ways to do this.4. Contentstack Community account. If you do not have one, visit&nbsp;community.contentstack.com/&nbsp;and register for a new account. You can adjust your email notifications under your profile at&nbsp;https://community.contentstack.com/settings/general&nbsp;﹥ Settings.

Automate Foundations

Automate Foundations