Workflow (Automation)
Build automations that create tasks, run AI reviews, notify your team, and push work into your other tools — on a schedule or the moment something happens.
A workflow is a saved automation: a trigger, plus one or more steps that follow it. The trigger decides when it runs — on a schedule, or in response to something happening in your workspace. The steps decide what happens next.
They handle the work that is easy to describe and easy to forget: raise a task every time a client comments, run an AI review on a page every month, push new tasks into Slack, or send a report at the end of each week.

Who this is for
Workflows sits in the left navigation and is permission-gated. If your role does not carry workflow access, the item will not appear. Creating a workflow needs a separate create permission, so it is possible to see existing workflows without being able to add new ones.
The words Atarim uses
Workflows has its own vocabulary, and the interface is consistent about it. Knowing these five terms makes everything else easier to follow.
| Term | What it means |
|---|---|
| Workflow | A saved automation — a trigger plus one or more steps. |
| Template | A pre-built workflow blueprint. Using one creates a workflow you then own and can edit. |
| Trigger, Action, Condition, Step | The building blocks. A trigger starts a workflow; actions and conditions are the steps that follow it. |
| Time (cadence) | How often a workflow runs, in plain language: On demand, Daily, Weekly, Monthly, Quarterly, or Yearly. On demand means it is event-triggered with no schedule. |
| Run | A single execution, recorded with a status, timing, and a step-by-step trace. |
Finding your way around
Select Workflows in the left navigation. The screen has three tabs.
| Tab | What it covers |
|---|---|
| Templates | Ready-made workflows you can adopt in a couple of clicks. Each shows its estimated credit cost. |
| Manage | Headed Your Workflows — everything you have created, with controls to edit, activate, attach projects, and delete. |
| Runs | Every execution of every workflow, with status, timing, and a link into the detailed trace. |
If you have not built anything yet, the Manage tab shows No Workflows Yet with a Create Your First Workflow button.
Using a template
Templates are complete, working workflows. Adopting one creates your own copy, which you then own and can change freely.

Building a workflow from scratch
Select Create New on the Manage tab to open the canvas. The canvas has a step library down the left and your workflow in the middle.
Step 1 — Add your trigger
Step 2 — Add your steps
Step 3 — Set the task context where it matters
This is the part people miss. When an action step follows other steps, its panel gains a Task context field, which decides which task that step acts on.
| Task context | The step acts on |
|---|---|
| Trigger task | The task that started the workflow. This is the default and what you want most of the time. |
| A previous step | Something an earlier step created or acted on — for example a task created by an Add task step further up. |
Step 4 — Name, save, attach, activate

Using placeholders in your steps
Placeholders insert live task data into text as the workflow runs. They are written between double percent signs — %%task_title%% — and are replaced with real values at run time.
They are not accepted everywhere. Only two fields process them:
| Step | Field | Placeholders |
|---|---|---|
| Send HTTP request | Payload | Supported |
| Notify person(s) | Message | Supported |
| Notify person(s) | Title | Not supported — a placeholder here is sent as literal text. |
| Add task comment | Comment | Not supported |
| All other steps | — | Not supported |
%%task_title%% arrives as those literal characters. Put the dynamic detail in the Message instead and keep the title fixed.
A worked notification
Title (fixed text): New client feedback
%%comment_author%% commented on %%task_title%%: "%%comment_message%%" — see %%task_page_url%%
The recipient gets a notification headed “New client feedback” with the author, task, comment text, and a link filled in.
Trigger reference
Every workflow needs exactly one trigger, and none of them cost credits. Twelve are available.
| Trigger | Fires when | Shown on the canvas as |
|---|---|---|
| Schedule | A cadence you define runs — daily, weekly, monthly, quarterly, or yearly. | On schedule |
| Task added | A new task is created. | When task added |
| Task comment added | A new comment is left on a task. | When task comment added |
| Task tag added | A tag is added to a task. | When task tag added |
| Task status changes | A task’s status changes. | When task status changes |
| Task priority changes | A task’s priority changes. | When task priority changes |
| Task completed | A task is completed. | When task is completed |
| Incoming Email | An email arrives in your connected inbox. | When an email is arrived |
| Graphic Added | A new image is created. | When graphic is added |
| Workflow Started | Another workflow starts. | When workflow starts |
| Workflow Completed | Another workflow completes. | When workflow completes |
| Workflow Failed | Another workflow fails. | When workflow fails |
Condition reference
Conditions check something before a workflow continues. Six are available, and none cost credits.
| Condition | Checks |
|---|---|
| Task status is set to | The task is at a particular status. |
| Task priority is set to | The task is at a particular priority. |
| Assigned user | The task is assigned to a particular person. |
| Task tag is set to | The task carries a particular tag. |
| Page status is set to | The page is at a particular status. |
| Email field contains | An incoming email field contains specific text — useful for routing by sender or subject. |
Task actions
The everyday building blocks. None of these cost credits.
| Step | What it does | Fields you set |
|---|---|---|
| Add task | Creates a task. | Project, and the task Comment (required). |
| Add task comment | Adds a comment to the task. | Comment (required). |
| Change task status | Moves the task to a different status. | Status (required). |
| Change task priority | Changes the task’s priority. | Priority (required). |
| Change task assignee | Reassigns the task. | Assignees — multi-select, required. |
| Add task tag | Applies one or more tags. | Tags — multi-select, required. |
| Remove task tag | Removes one or more tags. | Tags — multi-select, required. |
| Complete task | Marks the task done. | No configuration. |
| End Task Timer | Stops a running timer on the task. | No configuration. |
Flow control: Delay
Delay pauses the workflow before it continues to the next step. It costs no credits, and it is what turns a simple automation into a follow-up system.
Practical uses for a delay
Three patterns that use a delay well:
AI actions
These are the only steps that consume credits beyond the base cost of running the workflow. Costs shown are per step, per run.
| Step | Cost | What it does | Fields you set |
|---|---|---|---|
| AI design review | 10 | Runs a headless AI design review across a project or a single page. | Project and Review intent (both required), optional Page and Review prompt, and Output mode — a batch of tasks, a summary report, or both. |
| AI project brief | 5 | Runs brand kit discovery to generate or update the project brief. | Project (required) and Mode — overwrite the existing brief or append to it. |
| AI website agent prompt | 5 | Runs a website or task AI agent against your own prompt. | Prompt (required), Output destination — a new task, a comment, or a report — and an optional Project. |
| Create AI image | 5 | Generates an image from a prompt. | Prompt (required), Dimensions — square, landscape, or portrait — Output — store as an asset or attach to the task — and an optional Project. |
| Do It (AI execution) | 5 | Finds and completes pending Do It actions on tasks in scope. | Task scope — the current task, all tasks in the project, or filtered tasks — On completion — mark complete or mark pending review — plus an optional confidence threshold and Project. |
Project, page, and image actions
| Step | What it does | Fields you set |
|---|---|---|
| Create New Site | Creates a project from a URL. Respects your workspace project limit. | URL (required) and an optional Title. |
| Add page | Adds a page to a project. | Project (required), and a Page URL source — entered manually or taken from an earlier step — plus an optional Page name. |
| Update Page Status | Changes a page’s status. | Page status. |
| Create Graphic Site | Creates an image project from an uploaded file, converting it where needed. | Optional Original filename and Graphic title. |
| Add graphic image | Adds an image to an existing image project. | Graphic project and Image source (required) — upload a file or use the output of a previous step. |
| Add graphic image version | Adds a new version of an existing image. | Graphic (required). |
Notification and email actions
| Step | What it does | Fields you set |
|---|---|---|
| Notify person(s) | Sends a notification inside Atarim. | Recipients, Title, and Message — all required. |
| Send notification to Slack | Posts to your connected Slack workspace. | Notification type (required). |
| Forward Email | Forwards an incoming email onward. | Forwarding emails (required). |
| Respond to Email | Replies automatically to an incoming email. | Message (required) and an optional Subject. |
Integration actions
Each of these pushes an Atarim task into an external tool. None cost credits, but all require that integration to be connected first under Settings → Integrations. The fields differ because each tool organises work differently.
| Step | Fields you set |
|---|---|
| Add Task to Asana | Project and Section — both required. |
| Add Task to Basecamp | Project, To-do set, and To-do list — all required. |
| Add Task to Clickup | Folder and Task list — both required. |
| Add Task to Jira | Project — required. |
| Add Task to Monday | Board (required) and an optional Group. |
| Add Task to Teamwork | Project and Task list — both required. |
| Add Task to Trello | Board and List — both required. |
Output actions
| Step | Cost | What it does | Fields you set |
|---|---|---|---|
| Send HTTP request | 0 | Sends data to any external service that accepts a webhook. | URL and HTTP method (required), plus optional Headers and Payload. Covered in full below. |
| Create Workflow PDF Report | 1 | Exports a PDF summary of the run, covering its steps, timing, and outputs. | No configuration. |
Example workflows
Seven patterns built from the triggers and steps above. Each names the trigger, the steps in order, and what problem it solves.
1. Turn client feedback into assigned work
The problem: comments arrive on a project and nobody notices until someone opens the dashboard.
Build it like this:
Feedback becomes assigned work the moment it is left, with no credits consumed.
2. Chase a task that has gone quiet
The problem: work moves to In Progress and then sits there.
Build it like this:
Stale work chases itself instead of waiting for a status meeting.
3. Nudge a client who has not replied
The problem: work is blocked waiting on client approval and nobody wants to keep asking.
Build it like this:
The follow-up happens on time and reads as considerate rather than nagging.
4. Monthly site review with a client-ready report
The problem: retainer clients expect proactive work, and nobody has time to audit every site by hand.
Build it like this:
Roughly 21 credits a month per project, including the base run cost, and the report writes itself.
5. Route incoming client emails
The problem: requests arrive by email and get lost between inboxes.
Build it like this:
The client gets an immediate reply, and the request lands as a task rather than sitting in someone’s inbox.
6. Push urgent work into your dev tool
The problem: developers work in Jira and never see Atarim.
Build it like this:
Only genuinely urgent work crosses over, so the dev board does not fill with noise.
7. Know when your automations break
The problem: a workflow fails quietly and nobody notices for weeks.
Build it like this:
One cheap workflow that watches all the others. Build this first.


Managing your workflows
The Manage tab lists everything you have built:
| Column | What it shows |
|---|---|
| Workflow Name | The name you gave it. |
| Project | Which projects it is attached to. A workflow with none attached cannot be activated. |
| Status | Whether it is active. Toggle here to switch it on or off. |
| Time | Its cadence — On demand, Daily, Weekly, Monthly, Quarterly, or Yearly. |
| Created By | Who built it. |
| Last Modified | When it was last edited. Selecting this heading sorts the list. |
| Runs | How many times it has run successfully. Failed runs are not counted here. |
| Cost | Estimated credits per run. |
| Actions | Edit and delete. |
Attaching projects
Activating and pausing
Editing and deleting

Checking what actually happened
The Runs tab lists every execution, successful or not.
| Column | What it shows |
|---|---|
| Workflow | Which workflow ran. |
| Status | The outcome of the run as a whole. |
| Trigger | A plain-language summary of what fired it, such as When task comment added. |
| Started | When it began. |
| Duration | How long it took. |
| Steps | How many steps it worked through. |
Reading the statuses
Runs and steps use different words, deliberately.
| Level | Possible statuses |
|---|---|
| The run as a whole | Pending, Running, Success, Failed, or Skipped. |
| An individual step | Executed, Skipped, Failed, or Retrying. |
Reading a run trace
Opening a run shows the workflow drawn out with each step’s status on it, alongside a summary panel. The panel gives you:


How to set up a custom webhook
The Send HTTP request step sends data from Atarim to any external service that accepts a webhook — Make, Zapier, n8n, a serverless function, or your own endpoint. It is the escape hatch for anything the built-in integrations do not cover, and it costs no credits.
The four fields
| Field | What to enter |
|---|---|
| URL (required) | The endpoint you are sending to, copied from the receiving service. |
| HTTP method (required) | GET, POST, PUT, PATCH, or DELETE. Most webhooks expect POST. |
| Headers | Optional. JSON, or one header per line. Use this for an authorisation token. |
| Payload | Optional. The body to send, as JSON. Not sent on GET or DELETE. |
Step 1 — Get a test URL first
Before pointing a workflow at your real endpoint, send it somewhere you can inspect. This takes two minutes and saves a great deal of guesswork.

Step 2 — Add the step in Atarim
The trigger appears on the canvas as Step 1, under the When this happens label.
It joins the canvas as the next numbered step, under a Then do this label.
The panel shows the step’s name with its Action badge, followed by its fields. Required fields are marked with a red asterisk.



Step 3 — Write your payload
Start with something fixed, confirm it arrives, then add live data.
A static payload sends the same thing every time:


A dynamic payload uses placeholders, which are replaced with real values when the workflow runs:
{"title": "%%task_title%%", "status": "%%task_status%%", "url": "%%task_page_url%%"}

Mixed text and placeholders work too — a placeholder can sit anywhere inside a string:
{"summary": "New task %%task_title%% was created at %%created_at%%"}
Step 4 — Test and check what arrived
Step 5 — Switch to your live endpoint
{"Authorization": "Bearer YOUR_TOKEN", "Content-Type": "application/json"}A comment payload

The same approach works for comment data. A fuller payload might look like this:
{
"task_info": "Task ID: %%id%%, Site ID: %%site_id%%, Priority: %%task_priority%%, Status: %%task_status%%",
"author_details": "Author: %%task_config_author_name%%, Task Title: %%task_title%%",
"page_info": "Page URL: %%task_page_url%%, Page Title: %%task_page_title%%",
"comment_details": "Comment ID: %%comment_id%%, Comment Message: %%comment_message%%",
"task_timing": "Created At: %%created_at%%, Updated At: %%updated_at%%"
}
Placeholder reference
Placeholders are wrapped in double percent signs and replaced when the workflow runs.
| Placeholder | Inserts |
|---|---|
%%task_title%% |
The task’s title. |
%%task_status%% |
Its current status. |
%%task_priority%% |
Its priority. |
%%task_page_url%% |
The URL of the page the task sits on. |
%%task_page_title%% |
The title of that page. |
%%task_config_author_name%% |
Who created the task. |
%%id%% |
The task identifier. |
%%site_id%% |
The project identifier. |
%%created_at%% |
When the task was created. |
%%updated_at%% |
When it was last updated. |
%%comment_message%% |
The text of the most recent comment. |
%%comment_author%% |
Who left that comment. |
%%comment_id%% |
The comment identifier. |
%%task_title%% works; %%title%% on its own does not and will come through empty. If an older guide gave you short names, use the prefixed versions above instead.
What to use it for
Typical uses for the step:
What workflows cost
Every workflow run consumes AI credits. The cost shown on a template or in the Manage table is an estimate per run, summed from the trigger, the steps, and a base cost for running at all.
Usage appears in your credit history labelled Workflow Initiated, so you can see what your automations are consuming alongside everything else.
When a workflow switches itself off
Atarim watches for workflows that keep failing. After three consecutive failed runs, the workflow is deactivated automatically and an email is sent letting you know, with a link to it.
The failure count resets as soon as a run succeeds, so occasional failures will not trip it — only a genuine, repeated problem.
Known limitations
Where the feature stops:
FAQs
Do workflows cost credits?
Yes. Every run consumes credits, and the estimate is shown on each template and in the Manage table. Failed runs consume them too.
Why isn’t my workflow running?
Almost always one of three things: it is not switched on, it is not attached to a project, or your credit balance is negative.
Can a workflow run across all my projects?
You attach workflows to projects from the Manage tab. They only run against what they are attached to, and only within the current workspace.
What happens if a workflow keeps failing?
After three consecutive failures it deactivates itself and emails you. A single successful run resets the counter.
Does editing a template change everyone’s workflows?
No. Using a template creates your own workflow from it. Editing yours has no effect on the template or on anyone else.
Can one workflow trigger another?
Yes. There are triggers for when a workflow starts, completes, or fails, so automations can be chained or monitored.
Why does a step say Executed rather than Success?
Deliberate wording. Runs are Success or Failed; individual steps are Executed, Skipped, Failed, or Retrying. Executed means the step did its job.
Can I send workflow output to another tool?
Yes. There are steps for Asana, Basecamp, Clickup, Jira, Monday, Teamwork, and Trello, a Slack notification step, plus Send HTTP request for anything else.
Can I Cancel or Reset a Time Delay?
Once a delay has started it runs its course unless the workflow is switched off or conditions change. Delays are based on real-time activity at the point the workflow was triggered.
Common issues
- Workflows is missing from the sidebar. Your role does not carry workflow access. Ask an administrator to grant it.
- You can see workflows but not create them. Creating needs a separate permission from viewing. An administrator can add it.
- A workflow never runs. Check three things in order: is it active, is it attached to at least one project, and is your credit balance positive.
- A workflow switched itself off. It failed three times in a row. Check the Runs tab for the failures and read the trace before reactivating.
- Runs stopped without warning. Check your credit balance. A negative balance blocks runs rather than queuing them.
- The Runs count on Manage has not moved. That column counts successful runs only. Check the Runs tab — the workflow may be running and failing.
- Some steps say “Skipped”. A step is skipped when a condition ahead of it was not met. Open the trace and check that condition’s configuration.
- A step says “Executed” but nothing happened. Open the run trace and check that step’s configuration — particularly any project or field it depends on.
- A step’s dropdown is empty. Many step fields load options from your workspace. Choose the project the step applies to first, then reopen the dropdown.
Conclusion
Workflows pay off on the work nobody enjoys remembering — the monthly check, the update round, the task that should exist the moment a client comments. Start from a template, watch one run end to end before trusting it, and keep an eye on the Runs tab rather than the success count. Automations are only useful while they are actually running.
Tips & best practices
- Start from a template rather than a blank canvas. It is faster, and you learn the building blocks by reading something that already works.
- Name workflows after what they do, not what they use. “Monthly WordPress update round” beats “AI workflow 3” when you have a dozen of them.
- Test against one low-stakes project before attaching client work. The run trace will show you exactly what happened.
- Build a workflow that watches for failed workflows. It is the only way to hear about a broken automation promptly.
- Check the Runs tab, not the Runs count. The count hides failures entirely.
- Do the credit maths before choosing a daily cadence. Cost per run multiplied by runs per month is the number that matters.
- After any workflow deactivates itself, read the trace before switching it back on — otherwise it will simply fail three more times.