Recipes
Short, focused HOWTOs for common modifications and integrations. Each recipe assumes you've got something working already and want to add or change one thing — bridging the gap between reference docs (which describe options) and worked examples (which build whole processes).
New to Nembl? Start with Getting Started and the Examples library before recipes. Recipes assume you know the basic concepts.
Workflow recipes
Add an SLA timer to an existing service
Goal: when a request sits in a phase too long, escalate.
- Open the workflow's editor → click the phase you want to bound (e.g. "Procurement Review")
- Add an outgoing transition labeled
Escalation Timeoutto a new Process phase named "Escalate to Manager" - On the original phase's property panel, add a Timer as the trigger condition for the escalation transition:
48 hours - On the "Escalate to Manager" phase, set Responsible = the original assignee's manager (resolved via Org Structure)
- Add a transition from "Escalate to Manager" back to the original phase so the manager can hand it back after attention
- Publish the new version
For B2B SLA tracking, see SLA Policies.
Auto-assign work based on round-robin
Goal: distribute submissions evenly across team members.
- Create a DATA enrich phase right after Start
- Use a mathjs expression that picks the next assignee:
["alice", "bob", "carol"][mod(_instanceCounter, 3)] - Output Variable:
assignee - On the next Process phase, set Responsibility's resolved-from variable:
{{assignee}}
For capacity-aware assignment (pick the person with the fewest open tasks), use a CONSULTED Service Assist agent instead.
Loop a phase until a condition is met
Goal: keep retrying or revising until something changes.
- The Phase that does the work → connects to a Decision phase
- Decision condition: did it succeed? (
{{status}} == "completed") - Yes → next phase. No → loop back to the work phase (or to a Timer that delays the retry)
Common use: polling an external API for completion (DocuSign envelope signed?). Pattern is the same as the Vendor Approval example.
Branch by request priority
- Add a Decision phase right after Start
- Condition expressions:
{{priority}} == "Rush"→ Fast Track branch{{priority}} == "High"→ Normal branch with notification- else → Normal branch
- Each branch goes through the same downstream phases but with different SLA timers
Notifications & integration recipes
Wire Slack notifications when a phase completes
- In Slack, create an incoming webhook for the channel you want notifications in. Copy the webhook URL.
- In your workflow, add a Webhook Callout phase wherever you want a notification (often right after a key phase completes)
- Configure:
- URL: paste the Slack webhook URL
- Method: POST
- Body Template:
{ "text": "Request {{requestTitle}} just completed phase {{lastPhaseName}}" } - Response Format:
ignore(Slack returns plain "ok", not JSON)
- Publish
For the full Slack incoming-webhook setup, see Slack's docs at api.slack.com/messaging/webhooks (opens in a new tab).
Send an email at workflow completion
Two options:
Option A — your own SMTP / SendGrid / Resend webhook: Webhook Callout phase pointing at your provider's send-email endpoint, body template with to, subject, body.
Option B — built-in Nembl notification: assign the requester as Informed on the End phase. They'll get the email through their notification channel preferences.
Create a GitHub Issue from a Nembl request
- Build or use a GitHub connector that wraps
POST /repos/{owner}/{repo}/issues - Add an API Call phase after the request is triaged
- Configure with:
- Use Connector:
GitHub — Create Issue - Body params:
title = {{requestTitle}},body = {{requestDescription}},labels = ["from-nembl"]
- Use Connector:
- Capture the returned issue URL into a workflow variable so it's visible on the request
Form & data recipes
Pre-fill a form field from the URL
Append ?fieldName=value to the submit URL:
https://nembl.example.com/services/it-support/new-laptop/submit?employeeName=Jane%20SmithField IDs match the slug you set when creating the field.
Validate a field with a custom rule
- Form editor → click the field → Validation tab
- Add a regex pattern (e.g.
^[A-Z]{2,4}-\d{4}$for a project code format) - Custom error message: "Project code must be 2–4 letters, dash, 4 digits"
For richer multi-field validation, use a DATA validate phase right after Start that checks consistency across fields and rejects with a clear error.
Compute a derived value from form input
- Add a DATA enrich phase after Start
- Expression:
{{quantity}} * {{unitPrice}} - Output Variable:
total - Subsequent phases reference
{{total}}
IAM & access recipes
Grant a role only on specific tagged resources
This is exactly what ABAC is for. Example: grant read on Services tagged tier:public to all members.
{
"effect": "Allow",
"action": "read",
"resource": "Service",
"condition": { "resource.tags.tier": "public" }
}Attach the policy to the role / group / user that should have it.
Make an action require dual approval (4-eyes)
Use a workflow with two sequential APPROVAL phases, each requiring a different person. Configure both Approvers as different individuals (or as different Roles, e.g. "Engineering Manager" and "Finance Director"). The action only proceeds when both approve.
Revoke a user's access immediately
- Admin → IAM → Users → <user> → Deactivate. Sessions terminate within 1 minute.
- If they had API Keys, also Revoke each key at Admin → IAM → API Keys. (Deactivating the user does not auto-revoke their keys.)
Agent recipes
Set up an inbox-triage agent
- Admin → IAM → Agents → New Agent
- Type: Queue Intake. Source: MANAGED. Pick the
inbox-triagetemplate. - Provider + Model + bound Vault (your Anthropic key)
- Autonomy: start at Suggest for two weeks, watch its decisions, then promote to Act with approval if you trust it
- Bind it to your inbox: Admin → Inboxes → <inbox> → Settings → Triage Agent
Add an agent that drafts text on a workflow phase
- Create a CUSTOM Workflow Phase agent
- Prompt: "You are a Customer Success specialist. Read this refund request's notes and draft a 3-sentence response that acknowledges the issue and explains next steps. Tone: warm, professional."
- Assign as CONSULTED on the relevant phase. The agent's draft appears as a comment on the phase; the human Responsible reviews and uses or edits it.
Related
- Examples library — full end-to-end builds
- Workflow Builder Overview — the canvas these recipes use
- API Reference — programmatic alternatives to UI workflows
- FAQ — the troubleshooting side of recipes