In an earlier section, we learned about the Start step and how there are two types of Spells: Manual and Triggered. We’ll cover the differences between the types more in-depth in this section.

Manual Spells

Manual Spells are workflows which you want to kick off, well, manually. For Manual Spells, you define the inputs yourself in the Start step, and there are a few ways in which a Manual Spell can be started.

Defining inputs

Manual Spells need inputs, and since they aren’t predefined from another system, you need to define them yourself. Let’s say you want to research a competitor; you probably need to enter the competitor’s name.

To define your Spell’s inputs, click on the Start step to open the sidebar:

Blank Start step sidebar

Select “Manual” to show the Input options below:

Manual Start step sidebar

From here, you can click “Add Input”:

Manual Start step sidebar input creation flow

For each input, you’ll decide the type (remember, these are variables!), name, and other information. Once you’re done and click “Create”, it will show up in the sidebar:

Manual Start step sidebar with input created

Now, when we run the Spell, we’ll enter the Competitor Name to provide as the first variable. Let’s say this is enough for now - now how do we run it?

Running manual Spells

Run in Respell

If you have a Spell that you want to run every once in a while, and you want to type in the inputs yourself, you will probably run the Spell in Respell. Here’s what the Run page looks like:

(image: Run page)

The inputs you defined for the Spell will show up here, and to run the Spell you simply enter the info like you’re filling out a form and click Run. That’s it! Your workflow should now be running, and you get to see what’s happening with Spell Run Activity. When it’s finished, your results will show below the inputs.

Run Bulk in Respell

Let’s say you have a spreadsheet full of competitor’s names, and you’ve got a lot of competitors. Instead of entering them one by one, Respell lets you upload the spreadsheet to run the Spell on each row.

To use Bulk Run, go to the Spell Page and click the “Bulk Run” tab:

(image: Bulk Run page)

Next, upload your spreadsheet. You’ll need to tell your Spell which columns go to which inputs:

(image: Bulk Run input mapping)

Then you’re ready to run your Spell and watch it crunch through every row at the same time. You’ll see the progress on the page, and the runs will be grouped together when you view them in your Spell History.

This works for more than spreadsheets; any tabular data can be used! Spreadsheets, SQL query results, developer logs, etc.

Run API

If you want to integrate your Spells into your systems or product, you can do that as well. Every Manual Spell provides an API endpoint to call it directly, passing in the inputs as JSON.

To run your Spell via the API, go to the Spell Run page and click the “API” tab:

API tab on a manual spell page

We provide the code, including your API key, ready to copy & paste. See our API Reference to learn more.

Triggered Spells

Triggered Spells are automation on autopilot: when something happens in a different system, it “triggers” the Spell to start. For example, when a new candidate applies to a job posting, your Evaluate Applicant Spell might run to score that candidate’s resume and advance them automatically to the next stage (or reject them).

Setting up a trigger

You can set up a trigger when creating your Spell. In the editor, click on the Start step to bring up the sidebar:

Start step sidebar

Once you select the Trigger type, you’ll be prompted to enter some information:

  • The service to listen to events from
  • The event you want to trigger the Spell
  • Criteria or filters for events

Trigger Start step sidebar

Once you define the trigger and create it, your Spell is ready to accept events. The trigger won’t be active until you publish your Spell.

Running triggered spells

Well, that’s the thing: you don’t have to run them! Once the trigger is set up and live, your Spell will run every time the triggering event happens.

You can always view when your Spell runs and what happened in the Spell page’s History tab, or the main History page on the sidebar.

(image: Spell page History tab)