Skip to content

The moment it happens

Get pinged when a Box task is assigned to you

Tasks assigned to you on contract files show up in Slack with the message, due date and file link, while other people's are skipped.

Runs
The moment it happens
Apps
Box
AI
Not needed
Access
read (manage webhooks scope)

Send this to your assistant

Create a ClickRuntime automation: whenever I'm assigned a task on a file in my Box 'Contracts' folder, post the task message, due date and file link to me in Slack.

Paste it into your assistant. It tells you what it will send or change before it runs live.

First time? Adding ClickRuntime to your assistant takes about two minutes.

Why use it

Why teams use this automation

Box tasks are how people ask for a signature, a review or an approval on a file. The assignee gets a notification inside Box and maybe an email, but both are easy to overlook, and tasks come with due dates. An approval request that waits three days in someone's Box notification tray can hold up an invoice payment or a hiring decision, and the requester ends up chasing in person.

When a task is assigned in Box, an event reaches ClickRuntime. The workflow checks the signature to confirm it came from Box, skips any assignments meant for other people, and sends you a Slack message with the task text, the due date and a link to the file. You see only tasks that are yours.

It helps anyone who gets approval requests through Box and lives in Slack for day-to-day communication.

What you get out of it

  • Deadlines are met more often

    Seeing the due date in the message lets you plan around it. Approvals that used to be completed late because they were seen late now happen on time. A missed deadline on an approval can hold up a vendor payment.

  • Only your own tasks appear

    Assignments for other people are skipped, so the message means something when it arrives. A channel or direct message that carries only relevant items is one you keep reading. Noise you do not control is the main reason people stop reading notifications altogether.

  • Requesters stop chasing you

    When the person who asked knows you see tasks quickly, they spend less time following up. Fewer nudges means fewer interruptions for both of you. Colleagues learn they can rely on your response times.

  • Direct link to the file in question

    The message includes a link to the file, so reviewing begins in one click. You skip the step of opening Box, finding the task list and locating the document. Starting the review a minute sooner adds up across dozens of tasks every month.

  • Approvals keep business moving

    Invoices, hires and contracts often wait on one signature. Quick sight of the task reduces the time money and decisions sit blocked behind it. One quick signature can free a payment for a supplier waiting on the other end.

How it works

What happens, step by step

  1. When a task is assigned in Box, Box tells ClickRuntime straight away. ClickRuntime checks the message really came from Box.

  2. Tasks assigned to anyone else are ignored.

  3. If it's yours, you get a Slack message with the task, its due date and a link to the file.

Before it runs live

  • Connect Box
  • Paste your automation's link into the other app's webhook settings

What you get

RunsThe moment it happens
Get pinged when a Box task is assigned to youjust nowSucceeded
Slack · DMBox task: Please sign before Friday (due 2026-10-24) northwind-msa.pdf: https://app.box.com/file/1234567890

Build your own

Need it to work differently?

This template is a starting point. Copy the prompt and change it, or describe a different automation from scratch, with your own conditions, more apps or an AI step. Your assistant writes it, tests it and runs it on ClickRuntime.
  • Your own rules

    Conditions, thresholds, filters and exceptions, written the way you'd explain them to a colleague.

  • Any number of apps

    One automation can read from one app and update several others. Over 248 apps are ready, and anything with an API works too.

  • AI where it helps

    Summaries, classification, extraction and drafts use ClickRuntime's built-in AI, with no extra key.

  • On a schedule or on each event

    Runs as often as every 5 minutes, or the moment an app sends an event, and keeps track of what it already handled.

Changes you can ask for

  • Act only on the items that match your own rules, and skip the rest
  • Add an AI step, for example to summarize, sort or draft a reply
  • Add another app, for example also send it to Slack
  • Combine it with other Box steps into one automation

Under the hood

The code that runs this automation

This is the Python script that runs each time the automation starts. Your AI assistant writes it for you when you send the prompt, and you allow each step in your assistant. To change how the automation works, describe the change to your assistant and it updates the script for you. For every function it can use, see the script reference.
task_assigned_to_me_alert_box.pyexample
import base64, hashlib, hmac
from clickruntime import on_event, notify, http, credentials

MY_LOGIN = "me@example.com"  # your Box login

@on_event
def handle(event):
    key = credentials.secret("BOX_WEBHOOK_PRIMARY_KEY").encode()
    digest = hmac.new(key, event.body.encode() + event.header("box-delivery-timestamp").encode(), hashlib.sha256).digest()
    if not hmac.compare_digest(base64.b64encode(digest).decode(), event.header("box-signature-primary") or ""):
        return {"posted": False, "reason": "bad signature"}
    assignment = event.json["source"]
    if event.json.get("trigger") != "TASK_ASSIGNMENT.CREATED" or assignment["assigned_to"]["login"] != MY_LOGIN:
        return {"posted": False}
    file = assignment["item"]
    tasks = http.get(f"https://api.box.com/2.0/files/{file['id']}/tasks", headers={
        "Authorization": "Bearer " + credentials.connection("box", "main")}).json()["entries"]
    task = next((t for t in tasks if any(a["id"] == assignment["id"] for a in t["task_assignment_collection"]["entries"])), {})
    due = (task.get("due_at") or "no due date")[:10]
    notify.slack(f"Box task: {task.get('message', 'Review')} (due {due})\n{file['name']}: https://app.box.com/file/{file['id']}", channel="U012ABCDEF")  # your Slack member id
    return {"posted": True}

FAQ

Common questions

How does it know a task is assigned to me?
The event identifies the assignee, and the workflow compares it with your Box user. Assignments for anyone else are skipped. If more than one person on a team wants the alert, each needs their own setup or a rule listing their user.
Does it alert when a task is assigned to a group?
Box tasks are assigned to individual users, so each assignment is a separate event. If a task goes to several people, each one gets their own event and only the matching person receives a message.
Can the message be sent to me by direct message instead of a channel?
Yes. Slack posts can be sent to a channel or to you directly. A direct message keeps task notifications private to you. Ask your AI assistant for the destination you prefer and approve the update.
What permissions does it need?
read (manage webhooks scope). Nothing else in your accounts is used.
Does it need AI?
No. It runs without AI, so it doesn't use your plan's AI allowance.
How many runs does it use?
One run for each event the app sends.
Can I change how it works?
Yes. Describe the change to your AI assistant, for example a different schedule, channel or filter. It updates the automation, tests it and tells you what changed.

Set up “Get pinged when a Box task is assigned to you” from your assistant

Copy the prompt above, or connect your assistant first. Free plan, no credit card.