CrewAI Enterprise allows you to automate your workflow using webhooks. This article will guide you through the process of setting up and using webhooks to kickoff your crew execution, with a focus on integration with ActivePieces, a workflow automation platform similar to Zapier and Make.com.

​
Setting Up Webhooks

1

Accessing the Kickoff Interface

  • Navigate to the CrewAI Enterprise dashboard
  • Look for the /kickoff section, which is used to start the crew execution
    Kickoff Interface
2

Configuring the JSON Content

In the JSON Content section, you’ll need to provide the following information:
  • inputs: A JSON object containing:
    • company: The name of the company (e.g., “tesla”)
    • product_name: The name of the product (e.g., “crewai”)
    • form_response: The type of response (e.g., “financial”)
    • icp_description: A brief description of the Ideal Customer Profile
    • product_description: A short description of the product
    • taskWebhookUrl, stepWebhookUrl, crewWebhookUrl: URLs for various webhook endpoints (ActivePieces, Zapier, Make.com or another compatible platform)
3

Integrating with ActivePieces

In this example we will be using ActivePieces. You can use other platforms such as Zapier and Make.comTo integrate with ActivePieces:
  1. Set up a new flow in ActivePieces
  2. Add a trigger (e.g., Every Day schedule)
    ActivePieces Trigger
  3. Add an HTTP action step
    • Set the action to Send HTTP request
    • Use POST as the method
    • Set the URL to your CrewAI Enterprise kickoff endpoint
    • Add necessary headers (e.g., Bearer Token)
      ActivePieces Headers
    • In the body, include the JSON content as configured in step 2
      ActivePieces Body
    • The crew will then kickoff at the pre-defined time.
4

Setting Up the Webhook

  1. Create a new flow in ActivePieces and name it
    ActivePieces Flow
  2. Add a webhook step as the trigger:
    • Select Catch Webhook as the trigger type
    • This will generate a unique URL that will receive HTTP requests and trigger your flow
      ActivePieces Webhook
    • Configure the email to use crew webhook body text
      ActivePieces Email

​
Webhook Output Examples

Note: Any meta object provided in your kickoff request will be included in all webhook payloads, allowing you to track requests and maintain context across the entire crew execution lifecycle.
stepWebhookUrl - Callback that will be executed upon each agent inner thought
{
    "prompt": "Research the financial industry for potential AI solutions",
    "thought": "I need to conduct preliminary research on the financial industry",
    "tool": "research_tool",
    "tool_input": "financial industry AI solutions",
    "result": "**Preliminary Research Report on the Financial Industry for crewai Enterprise Solution**\n1. Industry Overview and Trends\nThe financial industry in ....\nConclusion:\nThe financial industry presents a fertile ground for implementing AI solutions like crewai, particularly in areas such as digital customer engagement, risk management, and regulatory compliance. Further engagement with the lead is recommended to better tailor the crewai solution to their specific needs and scale.",
    "kickoff_id": "97eba64f-958c-40a0-b61c-625fe635a3c0",
    "meta": {
        "requestId": "travel-req-123",
        "source": "web-app"
    }
}