HashiTalks 2025 Learn about unique use cases, homelab setups, and best practices at scale at our 24-hour virtual knowledge sharing event. Register
HashiCorp Cloud Platform
HashiCorp Cloud Platform Home

Create and manage actions

This page describes how to create HCP Waypoint actions and attach them to HCP Waypoint templates and applications. Platform engineers often perform these tasks. Refer to Actions for additional information.

Prerequisites

  • An HCP account with HCP Waypoint enabled. Refer to HCP Account for information about creating an account.

Create an action

To create an action, complete the following steps:

  1. From the HCP Waypoint overview, go to the Actions menu.
  2. Click Create an action.
  3. Enter an Action name and Description for the action.
  4. Add values to the Variables field to create any required local variables for the action.
  5. Optionally, enable the Enable this value to be defined when the action is triggered option for each variable you want to choose a value for when you run the action. Refer to HCP Waypoint variables reference for more information.
  6. Choose an Action type and enter the associated configuration parameters.
  7. Click Create action.

You can choose from the following action types:

  1. Custom: This action type configures HCP Waypoint to send an HTTP request to the specified source URL. The source URL cannot include a custom port. For information on using variables in a custom action, refer to the action variables reference documentation.
  2. Agent: This action type runs on an HCP Waypoint agent that you manage. Refer to the create and manage agents documentation for more information.

Run an action

To run an action, complete the following steps:

  1. From the HCP Waypoint overview, go to the Actions menu.
  2. Click on the name of the action you want to run.
  3. Click Run.

Delete an action

To delete an action, complete the following steps:

  1. From the HCP Waypoint overview, go to the Actions menu.
  2. Click on the 3 dots of the action under the Manage heading.
  3. Click Delete action.
  4. Enter DELETE in the form and click Delete.

Assign an action to a template

To assign or unassign an action to a template, complete the following steps:

  1. From the HCP Waypoint overview, go to the Templates menu.
  2. Click on the name of the template.
  3. Click Settings from the left menu.
  4. Click on Action assignments from the left menu.
  5. Check the checkboxes of the actions to assign them to the template and uncheck the ones you want unassign.
  6. Click Confirm.

Run an action assigned to an application

Applications inherit any actions assigned to the template they are created from. To run an action assigned to an application, complete the following steps:

  1. From the HCP Waypoint overview, go to the Applications menu.
  2. Click on the name of the application.
  3. Click on Actions and then click on the name of the action you want to run.
  4. Click on Run.

View action run history

To view an action's run history, complete the following steps:

  1. From the HCP Waypoint overview, go to the Actions menu.
  2. Click on the name of the action.

View action run history for an application

To view an action's run history for an application, complete the following steps:

  1. From the HCP Waypoint overview, go to the Applications menu.
  2. Click on the name of the application.
  3. Click on Action runs from the left menu.

Next steps

To learn more about what you can do with HCP Waypoint after you created an action, refer to the following topics: