X
Back to main site

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. Create an Entry
  2. Entry Workflow Stage
  3. Localize an Entry
  4. Publish an Entry
  5. Publish an Asset
  6. Unpublish an Entry
  7. Get Single Entry
  8. Update Entry

Let’s look at each of them in detail.

Create an Entry

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

  1. In the Configure Action section, select the Contentstack connector.
    1.Select_Contentstack_Connector.png
  2. Select the Create Entry action.
    2.Select_Create_Entry_Action.png
  3. In the Configure Action tab, click on + Add New Account to add your Contentstack account.
    3.Click_Add_New_Account.png
  4. In the pop-up window, provide OAuth permissions for all the values by checking the boxes and click on Authorize.
    Authorize_Popup.png
  5. In the pop-up that appears, select your organization to complete authorization.
    5.Select_Organization.png
  6. Provide an Account Name and click on Save.
    6.Set_Account_Name.png
  7. Select a Stack from the LOOKUP list.
    7._Select_Stack.png
  8. Select a Content Type from the LOOKUP list.
    8.Select_Content_Type.png
  9. Provide your entry data in the Entry Data field.

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

    9.Enter_Entry_Data.png
  10. Once done, click on Proceed.
  11. Click on Test Action to test the configured action.
    10.Click_Test_Action.png
  12. The output will be shown as follows. Click on the Save and Exit button to finish setting up the Create Entry action for the Contentstack connector.
    11.Click_Save&Exit.png

Entry Workflow Stage

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

  1. Select the Set Entry Workflow Stage action.
    12.Select_Set_Entry_Workflow.png
  2. In the Configure Action tab, click on + Add New Account to add your Contentstack account.
    13.Click_Add_New_Account.png
  3. In the pop-up window, provide OAuth permissions for all the values by checking the boxes and click on Authorize.
    Authorize_Popup.png
  4. In the pop-up that appears, select your organization to complete authorization.
    15.Select_Organization_2.png
  5. Provide an Account Name and click on Save.
    16.Set_Account_Name_2.png
  6. Select a Stack from the LOOKUP list.
    17.Select_Stack.png
  7. Select a Content Type from the LOOKUP list.
    18.Select_Content_Type.png
  8. Select an Entry ID from the LOOKUP list for which you want to set the workflow stage.
    19.Select_Entry_ID.png
  9. 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.

    20.Select_Workflow_Stage_ID.png
  10. Set a Due Date. This defines a date for the entry stage to be completed.
    21.Set_Due_Date.png
  11. With Notify via Email, you can choose to notify other members in the workflow about the action changes via email.
    22.Enter_Value_Notify_via_Email.png
  12. Under Workflow Comment, add a comment for the next stage user.
    23.Add_Workflow_Comment.png
  13. Click on Proceed.
    24.Click_Proceed.png
  14. Click on Test Action to test the configured action.
    25.Click_Test_Action.png
  15. If the setup is successful, you will see the following output. Click on Save and Exit.
    26.Click_Save&Exit.png

Localize an Entry

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

  1. Select Localize an Entry action.
    27.Set_Localize_an_Entry.png
  2. In the Configure Action tab, click on + Add New Account to add your Contentstack account.
    28.Click_Add_New_Account.png
  3. In the pop-up window, provide OAuth permissions for all the values by checking the boxes and click on Authorize.
    Authorize_Popup.png
  4. In the pop-up that appears, select your organization to complete authorization.
    30.Select_Organization_2.png
  5. Provide an Account Name and click on Save.
    31.Set_Account_Name_2.png
  6. Select the Stack API key from the LOOKUP list.
    32.Select_Stack_API_Key.png
  7. Under Content Type Name, select a content type from the LOOKUP list.
    33.Select_Content_Type.png
  8. Select an Entry ID from the LOOKUP list for which you want to create the locale version.
    34.Select_Entry_ID.png
  9. Select Locale from the LOOKUP list. It provides a list of languages present in your stack.
    35.Select_a_Locale.png
  10. Provide your entry data in the Entry Data field.

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

    36.Provide_Entry_Data.png
  11. Click on Proceed.
    37.Click_Proceed.png
  12. Click on Test Action to test the configured action.
    38.Click_Test_Action.png
  13. The output will be shown as follows. Click on the Save and Exit button to finish setting up the Localize an Entry action for the Contentstack connector.
    39.Click_Save&Exit.png

Publish an Entry

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

  1. Under Select an Action tab, select Publish Entry.
    Select_Action.png
  2. In the Configure Action tab, click on + Add New Account to add your Contentstack account.
    Add_An_Account.png
  3. In the pop-up window, provide OAuth permissions for all the values by checking the boxes and click on Authorize.
    Manage_Permissions.png
  4. In the pop-up that appears, select your organization to complete authorization.
    Authorize_Permissions.png
  5. Provide an Account Name and click on Save.
    Save_Account.png
  6. Select a Stack from the LOOKUP list.
    Select_Stack.png
  7. Select a Content Type from the LOOKUP list.
    Select_Content_Type.png
  8. Select an Entry from the LOOKUP list.
    Select_Entry.png
  9. Select an Environment from the LOOKUP list where you want to publish the entry.
    Select_Environment.png
  10. [Optional] Enable the Show optional fields toggle button to display the Locales and Publish Schedule fields.
    Show-optional_field.png
  11. Once done, click on Proceed.
    Proceed_Test_Action.png
  12. Click on Test Action to test the configured action.
    Test_Action.png
  13. On successful configuration, you can see the below output. Click on Save and Exit.
    Save_And_Exit.png

Publish an Asset

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

  1. Under Select an Action tab, select Publish Asset.
    Select-Action.png
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add-Account.png
  3. In the pop-up window, provide OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage-Permissions.png
  4. In the pop-up that appears, select your organization to complete authorization.
    Choose-Organization-2.png
  5. Provide an Account Name and click Save. 
    Set-Account-Name.png
  6. Select a Stack from the Lookup list. 
    Select-Stack.png
  7. Select an Asset from the Lookup list.

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

    Select-Asset.png
  8. Select an Environment from the Lookup list where you want to publish the asset.
    Select-Environment.png
  9. [Optional] Enable the Show optional fields toggle button to display the Locales and Publish Schedule fields. 
    Show-Optional-Fields.png
  10. Once done, click Proceed. 
    Proceed.png
  11. Click Test Action to test the configured action. 
    Test-Action.png
  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.png

Unpublish an Entry

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

  1. Under Select an Action tab, select Unpublish Entry.
    Select-Action.png
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account. 
    Add-Account.png
  3. In the pop-up window, provide OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage-Permissions.png
  4. In the pop-up that appears, select your organization to complete authorization.
    Choose-Organization-2.png
  5. Provide an Account Name and click Save.
    Set-Account-Name.png
  6. Select a Stack from the Lookup list. 
    Select-Stack.png
  7. Select a Content Type from the Lookup list.
    Select-Content-Type.png
  8. Select an Entry from the Lookup list.
    Select-Entry.png
  9. 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.png
  10. [Optional] Enable the Show optional fields toggle button to display the Locales and Unpublish Schedule fields.
    Show-Optional-Fields.png
  11. Once done, click Proceed.
     Proceed.png

  12. Click Test Action to test the configured action.
     Test-Action-New.png
  13. On successful configuration, you can see the below output. Click Save and Exit.
    Save-Exit.png

Get Single Entry

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

  1. Under Select an Action tab, select Get Single Entry. 
    Select-Action-New.png
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account.
    Add-Account.png
  3. In the pop-up window, provide OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage-Permissions.png
  4. In the pop-up that appears, select your organization to complete authorization.
    Authorize-Org-New.png
  5. Provide an Account Name and click Save.
    Set-Account-Name.png
  6. Select a Stack, Content Type, and Entry from the Lookup list. 
    Select-Stack-ContentType-Entry-New.png
  7. [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-New.png
  8. Once done, click Proceed.
  9. Click Test Action to test the configured action.
    Test-Action.png
  10. On successful configuration, you can see the below output. Click Save and Exit.
    Save-Exit.png

Update Entry

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

  1. Under Select an Action tab, select Update Entry. 
    Select-Update-Entry-Action-New.png
  2. In the Configure Action tab, click + Add New Account to add your Contentstack account. 
    Add-Account.png
  3. In the pop-up window, provide OAuth permissions for all the values by checking the boxes and click Authorize.
    Manage-Permissions.png
  4. In the pop-up that appears, select your organization to complete authorization.
    Authorize-Org-New.png
  5. Provide an Account Name and click Save.
    Set-Account-Name.png
  6. Select a Stack, Content Type, Entry Data, and Entry from the Lookup list.

    Note: Enter the data in JSON format only.

    Select-Stack-ContentType-Entry-EntryData-New.png
  7. [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.png
  8. Once done, click Proceed.
  9. Click Test Action to test the configured action.
    Test-Action.png
  10. On successful configuration, you can see the below output. Click Save and Exit.
    Save-Exit.png

This sets the Contentstack action connector.

Was this article helpful?

Thanks for your feedbackSmile-icon

On This Page

^