Skip to main content

Configure Custom Actions

Configure Custom Actions to extend Recruitment Manager functionality and automate interactions with third-party systems or FastTrack Marketplace vendors.

Written by Jason
Updated over 4 months ago

Enhance Recruitment Manager functionality by configuring Custom Actions that enable seamless interactions and requests between Recruitment Manager and third-party systems within the FastTrack Marketplace.

πŸ“Œ Note: Custom Actions extend system capabilities for both manual user-initiated requests and automated event-driven actions.

⚠ Important: You need Security permissions to configure Custom Actions.


Configure Manual Custom Actions

Manual Custom Actions allow users to trigger specific actions or integrations directly from within defined areas of the system.

These can be configured to display in any of the following areas:

  • Parent.

  • Client.

  • Cost Centre.

  • Client Contact.

  • Job Order.

  • Candidate.

  • Candidate Search.

  • Contact Search.

  • Referral Workflow.

  • Doco Management Header.

  • Doco Management – Doco List.

  • Doco Management – Pending List.

Steps to Configure a Manual Custom Action

  1. Go to Settings, then click Custom Actions.

  2. Select Add New Action, then choose Manual as the Action Type.

  3. Define the Action Name, Display Area, and any required Third-Party Endpoint details.

  4. Assign Security Permissions to determine which users can view and trigger the action.

  5. Click Save to apply the configuration.

How Manual Custom Actions Work

When a user with the correct permissions views a record that contains a configured Custom Action:

  1. The Custom Action button will appear on the record view.

  2. Selecting the action may either:

    • Open a pop-up window requesting additional input, or

    • Redirect the user to an external system to complete the request.

πŸ“Œ Note: If multiple Custom Actions are configured, users can choose the appropriate one based on the type of request being performed.

πŸ€“ Tip: Always inform users about what each Custom Action does and any prerequisites for completing the associated process.


Configure Event Custom Actions

Event Custom Actions automatically trigger based on system events without requiring user interaction.

You can configure an Action Type of Event for the following scenarios:

Event Type

Description

Job Order Fill

Triggers automatically when a job is filled by any method (manual, referral workflow, or API).

Referral Workflow Stage

Triggers automatically when a candidate moves into a defined stage via the UI or API (excluding the Filled Stage).

Steps to Configure an Event Custom Action

  1. Go to Settings, then click Custom Actions.

  2. Click Add New Action, and select Event as the Action Type.

  3. Choose the Event Trigger (e.g., Job Order Fill or Referral Workflow Stage).

  4. Enter the integration or endpoint details required to execute the action.

  5. Click Save to complete the setup.

πŸ“Œ Note: Event Custom Actions do not require security permissions, as they run automatically upon a successful event (for example, when a job is successfully filled).

⚠ Important: If a FastTrack360 API call is used to fill a job or progress a referral stage, any configured Event Custom Actions will trigger automatically after the API call succeeds.


Configure Marketplace Custom Actions

Marketplace Custom Actions allow agencies to send or receive requests from FastTrack Marketplace vendors.

Setup Process

  1. When a Marketplace account is established with a vendor, configuration details for the required Custom Action will be provided.

  2. Go to Settings, then select Custom Actions.

  3. Create a new Custom Action using the vendor’s provided configuration details.

  4. Click Save to finalize setup.

πŸ“Œ Note: For Marketplace integrations, sessionId data is retained in FastTrack systems for no longer than 7 days from creation.


πŸ’‘ Best Practices

  • Verify that all Custom Actions are tested in a sandbox environment before rollout.

  • Regularly review security permissions for Manual Custom Actions.

  • Document and communicate all configured actions to relevant users.

  • Ensure API-based Event Actions are validated for successful response handling.

  • Monitor Marketplace configurations to comply with vendor requirements.


πŸ€” FAQs

Q1: Why don’t I see the Custom Action button?

  • Answer: You may not have the required security permission, or the action is not configured for the current record type.

Q2: Can I trigger multiple actions at once?

  • Answer: Yes. If several Manual Custom Actions are configured, users can select one or more records and execute different actions based on the setup.

Q3: Do Event Custom Actions require user interaction?

  • Answer: No. They are fully automated and execute only when the linked event occurs successfully.

Did this answer your question?