Global Hooks Guide

​

Step 1: Navigate to the Global Hooks UI

1. Log in to your Mage account.

2. Click on Global Hooks in the left navigation pane
3. Once on the Global Hooks view, click on the ”+ Add new global hook” button.

​

Step 2: Configure the Hook

1. Hook UUID: Enter a unique name for your hook.
2. Resource Type: Select the type of resource (API call type) from the resource drop down.
3. Operation Type: Select the type of operation needed for your hook.

4. Targeting Conditions: Enter conditions if you want it to apply the hook to only certain pipelines. Leave this field blank to apply the hook to all pipelines.
5. Before Operation Starts Toggle: Toggle to on if you want the hook to run before an operation starts.
6. After Operation Completes Toggle: Toggle to on if you want the hook to run after an operation ends.
7. Run if Operation Succeeds Toggle: Toggle to on if you want to hook to run only if the operation succeeds.
8. Run if Operation Fails Toggle: Toggle to on if you want the hook to run if the operation fails.
9. Pipeline to Execute: Select the pipeline you want to execute the hook from.
10. Valid Code Snapshot: Click the “Create Snapshot of code” button to validate the pipeline code.

11. Stop Operation if Hook Fails Toggle: Toggle on if you want to stop the operation from running if the hook fails.
12. Execute Hook with History and Logging Toggle: Toggle to on if you want to log the hook’s execution, but be aware of potential performance impacts.

13. Run Hook Asynchronously: Enable this setting to run hooks asynchronously and not block the current resource operation from resolving
14. Block Outputs: To select block output features, Click the ”+ Add block outputs” button
15. Block to Extract Data From: If needed, select the block data will be merge from into the hook operation’s data.
16. Object to Merge Block into data: If needed, select the type of data that will be merged into the hook operation’s data.
17. Additional Dictionary Keys: Enter information into this field if you have nested objects in your block.

​

Step 3: Save and Test the Hook

1. Click the “Save changes” button to update the global hook with the new configuration changes.
2. To execute a global hook, perform the action or operation that matches the hook’s configured conditions, and the hook will run the designated code or pipeline based on its defined settings.