Skip to main content

Create onboarding tasks for new hires

Create one onboarding task for each item on a checklist when a candidate is marked Hired. Tape loops over the checklist and adds a task for every item.

Written by Leo

This recipe turns a status change into a set of tasks. A loop (a group of actions that repeats once for each record in a list) creates one task for every record in your onboarding checklist. It's meant to make sure every new hire gets the same start, without copying tasks by hand.

Scrolling through the automation Create onboarding tasks for new hires: When a record is updated and Status has changed in Candidates, the filter Status Has changed to Hired, Search for records in Onboarding checklist, and Loop actions for each Checklist step with Create a record in Tasks, where Title, Status To do, and Due date Current date + 7 Days are set

What you'll need

  • A Candidates database app with a Name text field and a Status field with the option Hired.

  • An Onboarding checklist database app. Each record is one step, with a Title such as "Order laptop" or "Create email account".

  • A Tasks database app with Title, Status (with To do), and Due date.

Build the automation

  1. Open the Candidates app on desktop or web and click the automations icon in the top bar (tooltip Create and view automations).

  2. Select New automation, then select When a record is updated.

  3. In the trigger, select the field name. Tape preselects one of the app's fields. Select Status under FIELDS, then select the preselected field again to remove it.

  4. Under And if the following conditions are met, select Add filter. Pick Status, then Has changed to, then Hired.

  5. Select Add action → Search for records. Choose the Onboarding checklist app and leave the filter empty to get every step.

  6. Select Add action → Loop actions. Under for each, select the records from Search for records.

  7. Inside the loop, select Add action → Create record. Choose the Tasks app.

  8. The step already has the required rows Title and Status. In Title, keep Set value, enter "Onboarding: ", insert the checklist step's Title, enter " for ", and insert the candidate's Name.

  9. In Status, choose To do. Select Add field to add Due date. It comes with Set date and Current date. Set the offset to 7 Days.

  10. Select Create automation.

Below Search for records in Onboarding checklist, selecting Add action and Loop actions, choosing Onboarding checklist under Collected so the loop reads for each Checklist step, then selecting Add action inside the loop, Create record, and the app Tasks, so the loop contains Create a record in Tasks

Note:

  • Set the status once. Has changed to makes the automation run once, when the status changes. Moving a candidate back and forth creates the tasks again.

  • A search returns at most 1,000 records. A run also stops after three minutes, so keep the checklist short.

  • Each created record counts as an action. Each Create record in the loop counts as an action, and a run can use at most 1,000 actions.

The result

When you set a candidate to Hired, one task per checklist step appears in Tasks, for example "Onboarding: Order laptop for Juliet Adams", each due in a week.

Variations

  • Filter the search by a Role field so engineers and sales hires get different checklists.

  • Add a Send email step after the loop to tell the hiring manager that the tasks were created.

  • Add an Assignee person field to the checklist and copy it to each task.

Learn more

FAQs

Can I loop over a number instead of a list of records?

Yes! Use a script to turn the number into a list, then loop over it. Learn how to create several records from a number →

Why did the loop create no tasks?

If no tasks appeared, it could be because:

  • The search found no records. Check the filter and the app you chose.

  • The for each setting is empty. Without a list to loop over, the actions inside the loop don't run.

Are you a developer using the Tape API for automations?

The automation API has its own documentation for developers. Full reference: for_loop in the developer docs →

Still have questions? Find answers and get help from community experts in the Tape community →

Did this answer your question?