Create custom actions and place them either on the Detail Page, Activity Timeline or right on the Card. There are different type of App Actions:
- System. Pre-existing ones like Edit or Delete Records.
- Automation. On App Action click, trigger your automation.
- Custom Code. Create your own flow.
- Mobile.
Edition Qualifier: App Actions are available for all FreeAgent CRM editions.
User Permissions: Only Administrators can create App Actions.
Prerequisites: For the Automation type, the desired Automation has to be created before adding a new App Action.
In this tutorial we will cover the following topics:
- Navigate to App Actions
- Create App Action
- Automations
- Custom Code App Actions
- Form Rules for App Actions
Navigate to App Actions
Open the menu and go to 'Admin Settings' to display the available options, then click App Setup to display all your existing Apps. Then select your desired app and click on 'App Actions'. You can also use the search function to get there faster, just start typing 'App Actions'.
Create App Action
There are a few elements to take into consideration when creating a new App Action, you can see the details for each of them in the table below:
| App Action Creation Fields | Description |
| Description | Used to add the details for the App Action. |
| Name | Identifies the App Action. |
| Icon | Enables you to select from the current icon selection. |
| Appearance | Default - Light grey colored button. Primary - The button will have the main color of the selected theme. Secondary - Light grey colored button. |
| Roles | Select the Roles that will have access to the App Action |
| Placement |
Activity Timeline. Adds it to the Actions button. Card. The Action will be listed in the 3 dots icon on the top right corner of the Card. Detail Page. The buttons will show up on the top right corner of the detail page of any record. Mobile. Enables the App Action on the mobile App. |
| Type |
Automation - It will allow you to select from any of the existing automations in the field available above. Custom Code - For more complex actions that might involve 3rd party apps. |
| Automation | If the type is 'Automation' here you will need to select the automation that will be triggered when the App Action button is clicked on. |
| Custom Code | Here is where you can add the code for your App Action. From simple status changes to more complex integrations with 3rd party apps. |
Once you have saved your App Action, if you go to the detail page of any record of that App, the App Action will be available according to the configured placement options.
Edit App Action
Select the App Action to modify and click the 'Edit' button. Make your changes and save once you are done.
Deactivate / Activate App Action
Select the App Action that you want to stop using and click the 'Deactivate' button. To start using it again, click the 'Show deactivated' checkbox to show all App Actions, select it and click the 'Activate' button.
Reorder App Actions
You can change the order in which the buttons appear on the detail page, just click the 'Reorder' button and drag&drop your App Actions in the desired order. Then just save your changes.
Automations
In order for the App Actions to do something, it is necessary to create an Automation for them. There are different types of Automations available, from the creation of new records or tasks to more elaborated ones, like those based on Custom Code. To learn more about Automations and how to create them, please visit the following tutorial:
Automations
Custom Code App Actions
These are recommended if you look to create complex flows within FreeAgent CRM and have your team trigger them with the click of a button.
Since these are based on Custom Code, the possibilities are endless.
Form Rules for App Actions
You can create a set of conditions for App Actions. If those conditions are not met, then it doesn't matter how many times you click the App Action button, nothing is going to happen. To learn more about them, please visit the following tutorial:
Form Rules