Overview
Webhooks allow you to receive real-time notifications when events occur in your BoostGPT project.Available Events
connector.created- MCP connector/server createdconnector.updated- MCP connector/server updatedconnector.cloned- MCP connector/server clonedconnector.deleted- MCP connector/server deletedmemory.created- Memory source createdmemory.updated- Memory source updatedmemory.deleted- Memory source deletedsubscriber.joined- Someone new reached the agent for the first time
subscriber.joined fires when a new contact is created — currently when someone new writes in by
email, or when a chat creates a member that did not exist before. The id is kept as-is rather than
renamed to contact.created, because existing automations reference it.Setup Webhook
1
Create Endpoint
Create an endpoint that accepts POST requests
2
Add Webhook in Dashboard
Go to Settings -> Webhooks -> Add Webhook
3
Enter URL
Provide your endpoint URL (must be HTTPS)
4
Select Events
Choose which events to receive
Webhook Payload
All webhooks send JSON payloads:Example Endpoint
Express.js
Next.js API Route
Verify Webhook Signature
Verify webhooks are from BoostGPT:Best Practices
- Return 200 quickly - Don’t process long tasks in webhook handler
- Use queues - Add events to a queue for async processing
- Verify signatures - Always verify webhook authenticity
- Handle retries - Respond with 200 to prevent retries
- Log events - Keep logs for debugging
Testing Webhooks
Test locally using ngrok:Next Steps
Error Handling
Handle webhook errors