cs-icon.svg

Contentstack Action

The Contentstack action connector lets you perform specific actions within your stack. With this connector you can create entries, set up workflow stages, and localize entries.

Set up Contentstack

The Contentstack action connector lets you perform the following actions:

  1. Get All Assets
  2. Get Single Asset
  3. Publish Queue
  4. Get All Content Types
  5. Get All Entries
  6. Delete an Entry
  7. Add Items to a Release
  8. Clone a Release
  9. Create a Release
  10. Delete Items from a Release
  11. Deploy a Release
  12. Get All Items in a Release
  13. Get All Releases
  14. Get Single Release
  15. Get User Information
  16. Create an Entry
  17. Entry Workflow Stage
  18. Localize an Entry
  19. Publish an Entry
  20. Publish an Asset
  21. Unpublish an Entry
  22. Get Single Entry
  23. Update Entry

Let’s look at each of them in detail.

Get All Assets

This action lets you fetch details of all the assets in your stack.

  1. Click Configure Action Step from the left navigation panel.
  2. Click Action Step to configure third-party services.
  3. Within the Configure Action Step, click the Contentstack connector.

    Note: You can sort and search the connector(s) based on the filter.

    Select_Connector.png
  4. Under Choose an Action tab, select the Get All Assets action.
    Select_Action.png
  5. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_an_Account.png
  6. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png
  7. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Select_Organization

    Note: Contentstack offers support for Branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  8. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  9. Provide an Account Name and click Save.
    Set_Account_Name
  10. Select a Stack, Environment, and Branch from the Lookup list.
    Select_Fields.png

    Note: By default, the main branch is selected (even if the Branch field is empty).

  11. Optionally, enable the Show optional fields toggle button to display the Asset Limit, Skip Asset (Pagination) fields.
  12. In the Select Folder dropdown, select a folder to fetch the details of all the assets present in the folder.

    Additionally, you can mark the Include count, Include publish details and Include metadata checkboxes to display the count of the total number of assets, publish and metadata details in the output.

    Show_Optional_Fields.png

  13. Once done, click Proceed.
  14. Click Test Action to test the configured action.
    Test_Action
  15. The output will be shown as follows. Click the Save and Exit button.
    Save_And_Exit.png

Get Single Asset

  1. Under Choose an Action tab, select Get Single Asset action.
    Select_Action.png
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_Account.png
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png

  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Select_Organization

    Note: Contentstack offers support for Branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Select a Stack, Environment, Asset, and Branch from the Lookup list. 
    Select_Different_Field.png

    Note: By default, the main branch is selected (even if the Branch field is empty).

  8. Optionally, enable the Show optional fields toggle button to display additional fields. Enter the asset Version to fetch the details of the asset. 
    Show_Optional_Fields.png
  9. Once done, click Proceed.
  10. Click Test Action to test the configured action.
    Test_Action
  11. The output will be shown as follows. Click the Save and Exit button.
    Save_Exit.png

Publish Queue

This action fetches all the entries present in the Publish Queue in Contentstack.

  1. Click Configure Action Step from the left navigation panel.
  2. Click Action Step to configure third-party services.
  3. Within the Configure Action Step, click the Contentstack connector.

    Note: You can sort and search the connector(s) based on the filter.

    Select_Connector.png
  4. Under Choose an Action tab, select the Publish Queue action.
    Select_the_Publsih_Queue_Action
  5. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_New_Account
  6. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png

  7. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Select_Organization

    Note: Contentstack offers support for Branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  8. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  9. Provide an Account Name and click Save.
    Set_Account_Name
  10. Select a Stack and Branch from the lookup list.
    Select_Different_Fields

    Note: By default, the main branch is selected (even if the Branch field is empty).

  11. [Optional] Enable the Show optional fields toggle button to display the Customized Data (query), Entry Limit, and Skip (Pagination) fields. You can also include the count for the total number of entries by clicking the checkbox.
  12. Provide your data in the Customized Data (query) field to filter the entry. Enter your data in a key-value pair in JSON format.

    Additional Resource: Refer to the Content Delivery API documentation to know more about queries.

    Show_Optional_Fields
  13. Once done, click Proceed.
  14. Click Test Action to test the configured action.
    Test_Action
  15. The output will be shown as follows. Click the Save and Exit button.
    Save_and-Exit

Get All Content Types

This action fetches all the content types present in a stack.

  1. Under Choose an Action tab, select the Get All Content Types action.
    Select_Get_All_Content_Types_Action
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_New_Account
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png

  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Select_Organization

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Select a Stack, and Branch from the Lookup list. You can also include the total count of the content types and the branch details by clicking the respective checkboxes.
    Select_Different_Fields

    Note: By default, the main branch is selected (even if the Branch field is empty).

  8. [Optional] Enable the Show optional fields toggle button to display the Content Type Limit, Customized Data (query), and Skip Content Type (Pagination) fields. Click the checkbox to include the global field schema details.
  9. Provide your data in the Customized Data (query) field to filter the retrieval of content types. Enter your data in the Key, and Value fields.

    Additional Resource: Refer to the Content Delivery API Docs for more information on Queries.

    Select_Show_Optional_Fields

    Note: The Customized Data (query) field acts as a filter to fetch the content types that fulfill the specifications provided in the Key-Value fields.

  10. Once done, click Proceed.
  11. Click Test Action to test the configured action.
    Test-Action
  12. The output will be shown as follows. Click the Save and Exit button.
    Save_and_Exit

Get All Entries

This action fetches all the entries present in a stack.

  1. Under Choose an Action tab, select the Get All Entries action.
    Select_get_All_Entries_Action
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_New_Account
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png

  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Select_Organization

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Select a Stack, Branch, and Content Type from the Lookup list.
    You can fetch the UID for all the previously configured automation steps directly from the Lookup list as shown below:
    Suggested_Data_Elements
    Select_Different_Fields

    Note: By default, the main branch is selected (even if the Branch field is empty).

  8. [Optional] Enable the Show optional fields toggle button to display the Entry Limit, Skip Entry (Pagination), Entry Version, and Select Locale fields.
    Select_Show_Optional_Field_1
  9. Provide your data in the Customized Data (query) field to filter the entry. Enter your data in the Key, Operator, and Value fields.
    In the Customized Data (query) field, you can filter the entry based on Updated At/Created At options. For example, you can fetch all the entries updated after a certain time and date as shown below:
    Customized_Query

    You can view the Lookup data for all the fields present in the content type including Reference, Modular Blocks and Group fields. Using the Operator filter you can sort the data.

    Add_Customized_Query

    Additional Resource: Refer to the Content Delivery API Docs for more information on Queries.

    In the Reference field, enter the ID of the reference field of your content type.

    You can also include the count of the entries, metadata details, workflow, branch and publish details by clicking the respective checkboxes.

    Reference_Fields

    Note: The Reference and the Customized Data (query) fields act as filters to fetch only those entries that fulfill the specifications provided in both the fields.

  10. Once done, click Proceed.
  11. Click Test Action to test the configured action.
    Test-Action
  12. The output will be shown as follows. Click the Save and Exit button.
    Save_and_Exit_Button

Delete an Entry

This action deletes an entry in a stack.

  1. Under Choose an Action tab, select the Delete an Entry action.
    Select_Delete_an_Entry_Action
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_New_Account
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png

  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Select_Organization

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Select a Stack, Branch, Content Type, and Entry from the Lookup list.
    Select_Different_Fields

    Note: By default, the main branch is selected (even if the Branch field is empty).

  8. [Optional] Enable the Show optional fields toggle button to display the Locale field. Click the Delete all the localized entries checkbox to delete all the localized versions of the entry.

    Note: If you provide the locale and click the Delete all the localized entries checkbox, all the localized entries will be deleted along with the fallback language i.e., English-United States (M) and the value passed in the locale field will become null.

    Show_Optional_Fields

    Note: If you select the fallback language in the locale field, i.e., English-United States (M), and uncheck the checkbox, the entry in the fallback language will be deleted and localized entries will be preserved.

  9. Once done, click Proceed.
  10. Click Test Action to test the configured action.
    Test_Action
  11. The output will be shown as follows. Click the Save and Exit button.
    Save_and_Exit

Add Items to a Release

This action lets you add multiple items to a release.

  1. Under Choose an Action tab, select the Add Items to a Release action.
    Select_the_Add_to_Release_Action_New
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_New_Account
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png

  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage_Permissions

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Select a Stack, Branch, and Release from the Lookup list. Provide your item data in the Release Item Data field.

    Note: Provide your entry data as per the schema in JSON format only. Both entries and assets can be added to the release. In case of assets, the value for the content_type_uid key should be built_io_upload.

    Select_Different_Fields

    Note: By default, the main branch is selected (even if the Branch field is empty).

  8. [Optional] Enable the Show optional fields toggle button to display the branch details by clicking the Include branch checkbox.

    Show_Optional_Fields
  9. Once done, click Proceed.
  10. Click Test Action to test the configured action.
    Test_Action
  11. The output will be shown as follows. Click the Save and Exit button.
    Clcik_the_Save_And_Exit_Button

Clone a Release

This action lets you create a copy of a release.

  1. Under Choose an Action tab, select the Clone a Release action.
    Select_Clone_A_Release_Action
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_New_Account
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png

  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage_Permissions

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Select a Stack, Branch, and Release from the Lookup list.
    Select_Different_Fields

    Note: By default, the main branch is selected (even if the Branch field is empty).

  8. Provide a Release Name and a Release Description for the release to be created.
    Select_Release_Name_And_Description
  9. [Optional] Enable the Show optional fields toggle button to display the branch details by clicking the Include branch checkbox.
    Show_Optional_Fields
  10. Once done, click Proceed.
  11. Click Test Action to test the configured action.
    Test_Action
  12. The output will be shown as follows. Click the Save and Exit button.
    Cliik_the_Save_And_Exit_Button

Create a Release

This action lets you create a release.

  1. Under Choose an Action tab, select the Create a Release action.
    Select_Create_a_Release_Action_New
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_New_Account
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png

  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage_Permissions

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Select a Stack, Release Name, Release Description, and Branch from the Lookup list.
    Select_Different_Fields

    Note: By default, the main branch is selected (even if the Branch field is empty).

  8. [Optional] Enable the Show optional fields toggle button to display the branch details by clicking the Include branch checkbox.
    Show_Optional_Fields
  9. Once done, click Proceed.
  10. Click Test Action to test the configured action.
    Test_Action
  11. The output will be shown as follows. Click the Save and Exit button.
    Save_And_Exit

Delete Items from a Release

This action lets you delete multiple items from a release.

  1. Under Choose an Action tab, select the Delete Items from a Release action.
    Select_Delete_Items_from_a_Release_New
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_New_Account
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png
  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage_Permissions

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button.png
  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Select a Stack, Branch, and Release from the Lookup list. Provide your item data in the Release Item Data field.

    Note: Provide your entry data as per the schema in JSON format only. 

    Select_Different_Fields

    Note: By default, the main branch is selected (even if the Branch field is empty).

  8. [Optional] Enable the Show optional fields toggle button to display the branch details by clicking the Include branch checkbox.
    Show_Optional_Fields
  9. Once done, click Proceed.
  10. Click Test Action to test the configured action.
    Test_Action
  11. The output will be shown as follows. Click the Save and Exit button.
    Save_And_Exit

Deploy a Release

This action lets you deploy a release to an environment.

  1. Under Choose an Action tab, select the Deploy a Release action.
    Select_Deploy_a_Release_Action_New
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_New_Account
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize

    Management_Token.png

  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage_Permissions

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Select a Stack, Branch, and Release from the Lookup list.
    Select_Different_Fields

    Note: By default, the main branch is selected (even if the Branch field is empty).

  8. Select an Environment, and Locale to deploy the release from the Lookup list.
    Select_Environment_Locale
  9. [Optional] Enable the Show optional fields toggle button to display the Publish Schedule field to schedule the deployment of the release.

    Note: The release will be published immediately if the Publish Schedule field is empty.

    Show_Optional_Fields
  10. Once done, click Proceed.
  11. Click Test Action to test the configured action.
    Test_Action
  12. The output will be shown as follows. Click the Save and Exit button.
    Save_Exit

Get All Items in a Release

This action fetches all the items present in a release.

  1. Under Choose an Action tab, select the Get All Items in a Release action.
    Select_Get_All_Items_in_a_Release_Action_New
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_New_Account
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png

  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage_Permissions

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Select a Stack, Branch, and Release from the Lookup list.
    Select_Different_Fields

    Note: By default, the main branch is selected (even if the Branch field is empty).

  8. [Optional]Enable the Show optional fields toggle button to display the Locale. You can also include the branch details by clicking the Include branch checkbox.
    Show_Optional_Fields
  9. Once done, click Proceed.
  10. Click Test Action to test the configured action.
    Test_Action
  11. The output will be shown as follows. Click the Save and Exit button.
    Save_Exit

Get All Releases

This action fetches all the releases present in a stack.

  1. Under Choose an Action tab, select the Get All Releases action.
    Select_Get_a_Release_Action
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_New_Account
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png

  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage_Permissions

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button

  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Select a Stack, and Branch from the Lookup list. Click the checkboxes for Include Count and Include count of release items to fetch the release details.
    Select_Different_Fields

    Note: By default, the main branch is selected (even if the Branch field is empty).

  8. [Optional]Enable the Show optional fields toggle button to display the Limit Release, and Skip Release fields. You can also include the branch details by clicking the Include branch checkbox.
    Show_Optional_Fields
  9. Once done, click Proceed.
  10. Click Test Action to test the configured action.
    Test_Action
  11. The output will be shown as follows. Click the Save and Exit button.
    Save_Exit

Get Single Release

This action fetches the details of a single release.

  1. Under Choose an Action tab, select the Get Single Release action.
    Select_Get_Single_Release
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_New_Account
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png

  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage_Permissions

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Select a Stack, Branch, and Release from the Lookup list.
    Select_Different_Fields

    Note: By default, the main branch is selected (even if the Branch field is empty).

  8. [Optional]Enable the Show optional fields toggle button to display the branch details by clicking the Include branch checkbox.
    Show_Optional_Fields
  9. Once done, click Proceed.
  10. Click Test Action to test the configured action.
    Test_Action
  11. The output will be shown as follows. Click the Save and Exit button.
    Save_Exit

Get User Information

This action gets a user's first name, last name and email address based on the user ID.

  1. Under Choose an Action tab, select the Get User Information action.
    Select_Get_user_information
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_new_Account
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png

  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage_Permissions

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Provide a User ID to fetch the user details.

    Note: To fetch the user ID, you need to configure an action, where user details can be fetched.

    Select_User_ID
  8. Once done, click Proceed.
  9. Click Test Action to test the configured action.
    Test_Action
  10. The output will be shown as follows. Click the Save and Exit button.
    Save_Exit

Create an Entry

This action lets you create an entry automatically in your stack. To know more, visit Create entries.

  1. Under Choose an Action tab, select the Create Entry action.
    Select_the_Create_Entry_Action
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_New_Account
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png

  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage_Permissions

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Select a Stack, Branch, and Content Type from the Lookup list. Provide your entry data in the Entry Data field.
    You can fetch the UID for all the previously configured automation steps directly from the Lookup list as shown below:

    Note: Provide your entry data as per your content type schema in JSON format only.

    Select_Different_Fields

    Note: By default, the main branch is selected (even if the Branch field is empty).

  8. In the Entry Data field, you can add a predefined schema template for your entry data. This will add a structure to provide your entry data in a particular format for different fields.

    Note: You must manually configure the entry data for JSON Rich Text Editor, Custom, and Experience Container fields.

    Select_Entry_Data_Field
  9. [Optional] Enable the Show optional fields toggle button to display the Locale. You can also include the branch details by clicking the Include branch checkbox.
    Select_Show_Optional_Fields
  10. Once done, click Proceed.
  11. Click Test Action to test the configured action.
    Test_Action
  12. The output will be shown as follows. Click the Save and Exit button to finish setting up the Create Entry action for the Contentstack connector.
    Save_Exit

Entry Workflow Stage

This action lets you set the workflow stage for your entry. Read more about workflow stages.

  1. Under Choose an Action tab, select the Set Entry Workflow action.
    Select_Workflow_Action
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_New_Account
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png

  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage_Permissions

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Select a Stack, Branch, and Content Type from the Lookup list. Also, select an Entry from the Lookup list for which you want to set the workflow stage.
  8. Select the Workflow Stage ID from the Lookup list.

    Note: If you select the Workflow Stage ID as Next Stage, the workflow stage of the selected entry will be updated automatically to the next stage. And, if your entry has reached the last stage of the workflow, a success message will be shown for the completed workflow.

    Select_Different_Fields

    Note: By default, the main branch is selected (even if the Branch field is empty).

  9. [Optional] Enable the Show optional fields toggle button to display the Due Date, Comment, Assignee Name, Assignee Role, and Locale fields.
  10. Select an Assignee Name and Assignee Role. With the Assignee Name, you can add the user to review the workflow updates, send an email notification and add comments for the assignee.
    With the Assignee Role, you can add the users with similar roles, such as developers, testers to check the workflow updates. 
    Assignee_Name_Role.png
  11. Set a Due Date. This defines a date for the entry stage to be completed. With Notify via Email, you can choose to notify other members in the workflow about the action changes via email.
  12. Under Comment, add a comment for the next stage user.
    Show_Optional_Fields
  13. Select a Locale from the Lookup list in which you want to set the workflow stage.
    Select_locale
  14. Click Proceed.
  15. Click Test Action to test the configured action.
    Test_Action
  16. If the setup is successful, you will see the following output. Click Save and Exit.
    Save_Exit

Localize an Entry

This action lets you create localized versions of your entries. Here’s a link to know more about Localization.

  1. Under Choose an Action tab, select the Localize an Entry action. 
    Select_localize_Entry_Action
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_new_Account
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png
  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage_Permissions

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Select the Stack, Branch ,Content Type, Entry, and Locale from the Lookup list.
    You can fetch the UID for all the previously configured automation steps directly from the Lookup list as shown below:
    Suggested_Data_Elements

    Note: Locale provides a list of languages present in your stack.

    Select_Different_Fields

    Note: By default, the main branch is selected (even if the Branch field is empty).

  8. Provide your entry data in the Entry Data field.

    Note: Provide your entry data in JSON format as per your content type schema.

  9. [Optional] Enable the Show optional fields toggle button to display the Include branch checkbox to include the branch details.
    Select_Entry_Data
  10. Click Proceed.
  11. Click Test Action to test the configured action.
    Test_Action
  12. The output will be shown as follows. Click the Save and Exit button to finish setting up the Localize an Entry action for the Contentstack connector.
    Save_and_Exit

Publish an Entry

This action lets you publish an entry automatically in your stack. To know more, visit publish entries.

  1. Under Choose an Action tab, select Publish Entry action.
    Select_Publish_Entry_Action
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_New_Account
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png

  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage_Permissions

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Select a Stack, Branch, Content Type, Entry from the Lookup list.
    You can fetch the UID for all the previously configured automation steps directly from the Lookup list as shown below:
    Suggested_Data_Elements
    Select_Different_Fields

    Note: By default, the main branch is selected (even if the Branch field is empty).

  8. Select an Environment and Locale from the Lookup list where you want to publish the entry.
    Env_Locale.png
  9. [Optional] Enable the Show optional fields toggle button to display the Publish Schedule fields. Click the Nested Reference Publishing checkbox to publish the entry along with the referenced entries.NRP.png
  10. Once done, click Proceed.
  11. Click Test Action to test the configured action.
    Test_Action
  12. On successful configuration, you can see the below output. Click Save and Exit.
    Save_Exit

Publish an Asset

This action lets you publish an asset automatically in your stack. To know more, visit publish assets.

  1. Under Choose an Action tab, select Publish Asset action. 
    Select_Publish_Asset_Action
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_new_Account
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png
  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage_Permissions

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Select a Stack, Branch, and an Asset from the Lookup list.
    You can fetch the UID for all the previously configured automation steps directly from the Lookup list as shown below:
    Suggested_Data_Elements

    Note: To dynamically fetch assets, configure the Asset Trigger and fetch the asset UID.

    Select_Different_Fields

    Note: By default, the main branch is selected (even if the Branch field is empty).

  8. Select an Environment from the Lookup list where you want to publish the asset. 
    Select_Environment
  9. [Optional] Enable the Show optional fields toggle button to display the Locale and Publish Schedule fields.
    Show_Optional_Fields
  10. Once done, click Proceed
  11. Click Test Action to test the configured action. 
    Test_Action
  12. On successful configuration, you can see the below output. Click Save and Exit. A publish and unpublish icon will appear for the asset on the entry page.
    Save_Exit

Unpublish an Entry

This action lets you unpublish an entry automatically in your stack. To know more, visit unpublish entries.

  1. Under Choose an Action tab, select Unpublish Entry action.
    Select_Unpublish_Entry_Action
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    aDD_nEW_aCCOUNT
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png

  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage_Permissions

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Select a Stack, Branch, Content Type, and Entry from the Lookup list.
    You can fetch the UID for all the previously configured automation steps directly from the Lookup list as shown below:
    Suggested_Data_Elements
    Select_Different_Fields
  8. Select an Environment from where you want to unpublish the entry.

    Note: Unpublishing an entry can only be done for one environment at a time.

    Select_Environment
  9. [Optional] Enable the Show optional fields toggle button to display the Locale and Unpublish Schedule fields.
    Show_Optional_Fields
  10. Once done, click Proceed.
  11. Click Test Action to test the configured action.
    Test_Action
  12. On successful configuration, you can see the below output. Click Save and Exit.
    Save_Exit

Get Single Entry

This action lets you fetch details of a single entry in your stack.

  1. Under Choose an Action tab, select Get Single Entry action.
    Select_get_Single_Entry_Action
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_New_Account
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed. //ss

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize. //ss

  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage_Permissions

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  6. Provide an Account Name and click Save.
    Set_Account_Name
  7. Select a Stack, Branch, Content Type, and Entry from the Lookup list.
    You can fetch the UID for all the previously configured automation steps directly from the Lookup list as shown below:

    Suggested_Data_Elements

    Note: By default, the main branch is selected (even if the Branch field is empty).

  8. [Optional] Enable the Show optional fields toggle button to display additional fields. Select the entry Version and Locale and check the Include Workflow, Include Publish Details, and Include branch checkboxes to fetch these details in addition to the entry details.
    Show_Optional_Fields
  9. Once done, click Proceed.
  10. Click Test Action to test the configured action.
    Test_Action
  11. On successful configuration, you can see the below output. Click Save and Exit.
    Save_Exit

Update Entry

This action lets you update an entry automatically in your stack.

  1. Under Choose an Action tab, select Update Entry action.
    Select_Update_Entry_Action
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add_new_Account
  3. Select a way to add a new account. You can authenticate your account in two ways; Contentstack OAuth or Management Token. Click Proceed.
    Authenticate_Account.png

    For Management Token, enter a Title and the Management Token of your stack. Click Authorize.

    Management_Token.png
  4. For Contentstack OAuth, open the pop-up window, provide the OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage_Permissions

    Note: Contentstack offers support for branches in Automation Hub. You must authenticate and re-authorize your existing account by checking all the permissions to add your Contentstack account.

  5. In the pop-up that appears, view the module-specific access rights provided to the app. Click Authorize to complete authorization.
    Click_the_Authorize_Button
  6. Provide an Account Name and click Save
    Set_Account_Name
  7. Select a Stack, Branch, Content Type, Entry Data, and Entry from the Lookup list.
    You can fetch the UID for all the previously configured automation steps directly from the Lookup list as shown below:

    Note: Enter the data in JSON format only.

    Suggested_Data_Elements

    Note: By default, the main branch is selected (even if the Branch field is empty).

  8. In the Entry Data field, you can add a predefined schema template for your entry data. This will add a structure to provide your entry data in a particular format for different fields.

    Note: You must configure the entry data for JSON Rich Text Editor, Custom, and Experience Container fields manually.

    Select_Different_Field_Entry_Data
  9. [Optional] Enable the Show optional fields toggle button to display additional fields. Select the Locale and check the Include branch checkbox to fetch these details in addition to the entry details. 
    Show_Optional_Fields
  10. Once done, click Proceed.
  11. Click Test Action to test the configured action.
    Test_Action
  12. On successful configuration, you can see the below output. Click Save and Exit.
    Save_and_Exit
Was this article helpful?
^