MuleSoft Cookbook

Practical recipes for MuleSoft developers — DataWeave patterns, error handling, performance tuning, AI agent integration, API management, CI/CD pipelines, migration guides, Salesforce integration, cost optimization, troubleshooting, enterprise architecture, messaging, and connector patterns.

What's Inside

Quick Start

Pick a section from the table above, or jump straight to the most popular content:

DataWeave (most popular)

%dw 2.0
output application/json
---
payload filter $.status == "active"
    map {
        name: $.firstName ++ " " ++ $.lastName,
        email: lower($.email)
    }

Browse all 102 patterns: dataweave/

Table of Contents

DataWeave Patterns (102)

Additional DataWeave Resources

• DW 2.x Cheatsheet | PDF
• Anti-Patterns & Common Mistakes
• DW 1.0 to 2.0 Migration Guide
• MEL to DataWeave Guide
• 7 Exchange Modules (96 functions, 213 MUnit tests)
• Playground Tips

Error Handling (51 recipes)

Global handlers, retry patterns, circuit breaker, dead letter queues, async errors, transactions, connector-specific errors, alerting, validation, and recovery patterns.

Browse all error handling recipes

Performance (49 recipes)

Streaming strategies, memory/heap tuning, batch optimization, connection pools, caching, threading model, API performance, database tuning, CloudHub sizing, HTTP/2 multiplexing, and monitoring.

Browse all performance recipes

API Management (57 recipes)

Flex Gateway deployment, AI gateway, custom WASM policies, rate limiting, OAuth/JWT/mTLS security, OWASP API Top 10 mapping, MCP/A2A gateway, agent governance, API design patterns, versioning, and analytics.

Browse all API management recipes

AI Agent Integration (63 recipes)

MCP server/client setup, A2A protocol, advanced MCP (OAuth, streaming, tracing), RAG pipelines, Agentforce actions, inference connector, Vibes prompt engineering and governance, LLM gateway, AI testing, multi-cloud LLMs, and AI security.

Browse all AI agent recipes

DevOps & CI/CD (53 recipes)

CI/CD pipelines (GitHub Actions, GitLab, Jenkins), environment promotion, IaC (Terraform, Helm), secrets management, deployment strategies (blue-green, canary), MUnit testing (batch, async, error, coverage), RTF, observability, and compliance.

Browse all DevOps recipes

Migrations (63 recipes)

Java version upgrades, Mule runtime migrations (3→4, 4.9→4.10, 4.10→4.11), CloudHub 1→2, API spec conversions, connector upgrades, security migrations, monitoring migrations, build tool upgrades, and architectural modernization.

Browse all migration recipes

Cost Optimization (7 recipes)

vCore right-sizing calculator, API consolidation patterns, usage-based pricing migration, dev sandbox cost reduction, CloudHub vs RTF vs on-prem TCO comparison, license audit checklist, and Anypoint MQ cost optimization.

Browse all cost optimization recipes

Salesforce Integration (9 recipes)

Bidirectional sync with conflict resolution, Bulk API 2.0 partial failure recovery, CDC vs Platform Events decision tree, governor limit-safe batch processing, Agentforce action registration, OAuth patterns, Composite API, Streaming API, and data migration strategies.

Browse all Salesforce recipes

Production Troubleshooting (8 recipes)

Thread dump analysis, top 30 error messages decoded, memory leak detection step-by-step, deployment failure flowchart, Anypoint Monitoring vs OpenTelemetry, connection pool exhaustion diagnosis, DataWeave OOM debugging, and batch job failure analysis.

Browse all troubleshooting recipes

Enterprise Architecture (8 recipes)

API-led anti-patterns, C4E setup playbook, event-driven architecture with MuleSoft, domain-driven API design, multi-region DR strategy, application network topology, microservices vs API-led, and integration maturity model.

Browse all architecture recipes

Messaging (7 recipes)

Anypoint MQ vs Kafka honest comparison, FIFO queue patterns, DLQ reprocessing, large payload workarounds, consumer circuit breaker, VM queue vs Anypoint MQ decision tree, and message ordering guarantees.

Browse all messaging recipes

Connector Patterns (8 recipes)

SAP IDoc processing, Workday custom reports, ServiceNow CMDB integration, NetSuite patterns, database change data capture, SFTP guaranteed delivery, EDI X12/EDIFACT processing, and AS2 message exchange.

Browse all connector recipes

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Adding a new pattern? Place it in the appropriate section folder with a README explaining the concept.

Adding a new section? Open an issue first to discuss the scope.

License

MIT — Copyright (c) 2026 Shakar Bisetty

Built by WeavePilot — practical MuleSoft recipes for the community.