Skip to main content

Overview

Webhooks allow you to receive real-time notifications when events occur in your BoostGPT project.

Available Events

  • connector.created - MCP connector/server created
  • connector.updated - MCP connector/server updated
  • connector.cloned - MCP connector/server cloned
  • connector.deleted - MCP connector/server deleted
  • memory.created - Memory source created
  • memory.updated - Memory source updated
  • memory.deleted - Memory source deleted
  • subscriber.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