API event driven actions

API event-driven actions let you automatically trigger an action when when specific events occur on an API.

Event driven custom action

1. Navigate to Inventory and select the APIs tab.
2. Select the API you want to attach the action to.
3. Click Actions, then Create Action.
4. Choose Event-Driven action.
5. Fill out the Action form:
   • Name - Enter a name for your action.
   • Description - Provide a brief description of the action.
   • Events - Select which event(s) will trigger this action.
   • Integration Type - Choose Custom.
   • (Optional) Auth provider - Select an existing Auth provider or click Create to set up a new one. Learn more about Auth providers here.
   • Integration - Choose a previously created Lambda or Webhook integration, or create a new one.
   • (Optional) Context - Click Add key to add key/value pairs for action parameters.
   • (Optional) Headers - Specify headers to be sent with action requests by adding key/value pairs.
6. Click Submit.

When your custom integration is triggered, FireTail will send a JSON payload to your chosen integration. View the Custom API action integration example.

Event driven managed action

1. Navigate to Inventory and select the APIs tab.
2. Select the API you want to create the action for.
3. Click Actions, then Create Action.
4. Choose Event-Driven action.
5. Fill out the Action form:
   • Name - Enter a name for your action.
   • Description - Provide a brief description of the action.
   • Events - Select which event(s) will trigger this action.
   • Integration Type - Choose Managed.
   • Select which managed action you want to use. Learn about each managed action here.
   • (Optional) Auth provider - Select an existing Auth provider or click Create to set up a new one. Learn more about Auth providers.
   • (Optional) Headers - Specify headers to be sent with action requests by adding key/value pairs.
   • API URL/Endpoint - The API base URL or Endpoint to test
6. Click Submit.

Note: API Contract Testing (if selected):

Additional settings for API contract testing

• Use event specification:
  • Enable to use the specification generated from the triggering event for validation.
  • Switch off to use a predefined API specification.
• API Specification: The API specification to be used during contract testing. This will be used when Use Event Specification is toggled off, or if no event specification exists.