Company
A Company is the top-level tenant in Firstwork. Users, hiring flows, automations, integrations, and data all belong to a company and run in that company’s isolated workspace. Company profile, branding, timezone, and language settings are configured in Company Details. For the object attributes that make up a company, see the Company entry in the Data Model.User
A User represents an individual person in the system. Users authenticate through the supported login methods and can relate to one or more companies through contracts. Use Roles and Access for portal roles and permissions, and the User entry in the Data Model for user attributes.Contract
A Contract represents the relationship between a User and a Company. It is the worker or admin record that tracks status, legal entity assignment, onboarding context, and access permissions.[!NOTE] A user can have multiple contracts, including historical contracts with the same company or active contracts with different companies.For contract fields, statuses, creation paths, and ACL behavior, see Contracts and the Contract entry in the Data Model.
Hiring Flow
A Hiring Flow defines the stages a candidate goes through during the recruitment process. It combines form pages, stages, decision rules, visibility rules, automations, and funnels into a public application workflow. Start with Pages, Stages, and Funnels for the operational setup.Application
An Application tracks a specific candidate’s progress through a Hiring Flow. It records the current stage, submitted form data, compliance status, and transition history. For day-to-day application management, see List Applications and View and Edit Applications. For object attributes, see the Application entry in the Data Model.Form
A Form is the configurable data collection structure behind hiring flows, onboarding flows, courses, templates, and integration steps. Forms are made from pages and form elements, and submissions store the collected answers. Use Pages for form structure, the Question Types section for supported field types, and the Form Entities section for the underlying objects.Compliance Rule
A Rule defines conditional logic that evaluates platform data. Rules power navigation, assignment, recollection, automation filters, and other decision points. Use Navigation Rules for hiring-flow rule behavior. Rules can compare static values, other fields, or Object Graph paths.Automation
An Automation is an event-driven workflow that runs actions in response to a trigger. Automations can send messages, update records, call integrations, create contracts, request recollection, and chain other workflows. For implementation details, start with Building Flows, then use the Triggers and Actions references. Runtime execution and concurrency behavior are covered in Workflow Mapping.Recollection
Recollection is the process for asking a candidate, applicant, worker, or contract holder to re-submit specific fields after data has already been collected. How it works:- An admin, automation, or template selects the fields to recollect and the reason for each field.
- Firstwork marks the latest matching form element submissions as pending recollection, stores the reason, and can optionally hide the previous value by clearing it for recollection.
- The recipient gets a recollection link by email or SMS. The link opens only the pending recollection fields rather than the full flow.
- The recipient submits the requested values. Firstwork validates that the payload matches currently pending recollection fields and updates the relevant submissions.
- Firstwork clears recollection flags for completed fields, updates the application or contract recollection status, and writes activity logs for requested, completed, partially completed, or cleared recollection.
- Recollection completion can trigger automations through
RECOLLECTIONtriggers or through post-recollection automations configured on aRecollect Dataaction.
- Recollection Config — Company, hiring-flow, or onboarding-flow settings for recollection behavior
- Recollection Reminders — Idle-day reminders for incomplete recollection requests
- Recollection Template — A reusable set of fields, reasons, notification templates, submission requirements, and clear-value settings
- Recollection Trigger — An automation trigger that listens for recollection completion for selected form elements
- Recollection Status — Applications and contracts move through
NOT_REQUESTED,REQUESTED, andCOMPLETED - Recollect Data Action — Sends a recollection request, can clear existing values, and can define automations to run after recollection
- Partial Completion — A recollection can complete only the fields that passed validation while leaving other requested fields pending
- Linked Applications — Recollection can include child hiring-flow applications and foreign-key-linked applications for the same user
Dynamic Data Recollection
Dynamic Data Recollection marks fields for correction based on validation output instead of sending a fixed recollection request for a predefined list of fields. It is useful when Firstwork detects invalid, missing, or inconsistent data while processing a form. The system stores validation errors on the affected field submissions, and the candidate or worker can correct those fields when they next load the flow.Self-Serve
Self-Serve lets applicants update eligible fields after their original submission without requiring an admin-triggered recollection request. Self-serve fields are controlled at the form element level. When an applicant updates data through self-serve, Firstwork can emit recollection-style automation events with aSELF_SERVE source so downstream automations can respond separately from standard recollection.
Dynamic Variables
Firstwork’s dynamic variable system lets templates, messages, webhook payloads, and automation fields insert runtime values with{{...}} placeholders.
Use Dynamic Variables for placeholder syntax and template behavior. Use the Object Graph when a placeholder needs to reference platform data by path.