Project transferred to another workspace
Lovable sends an automated notification to your secure web address whenever a project moves between workspaces. Both the source and destination workspaces receive their own copy of the event.
Workspace administrators or developers who need their external tools to react automatically when a project is transferred.
Do this, in order
- 1
Set up an Events & Hooks subscription in your workspace with your secure HTTPS endpoint.
Lovable needs an active destination address to deliver event notifications.
- 2
Verify the incoming signature on the notification request before processing it.
This ensures the request genuinely came from Lovable and has not been altered.
- 3
Inspect the workspace_id field in the received payload to identify which workspace received the delivery.
Both the sending and receiving workspaces get notifications sharing the same event ID, so the workspace ID indicates which side you are reading.
Paste this into your project
Create an API endpoint that receives Lovable webhook requests, verifies the incoming request signature, and handles the project.workspace_transferred.v1 event by logging the event ID and the associated workspace ID.
Words decoded
- HTTPS endpoint
- A secure web address on your server designed to receive data automatically from external services.
- Event ID
- A unique identifier assigned to a specific occurrence so related notifications can be matched together.
- Signature verification
- A cryptographic check to prove that a received message is authentic and untampered.
Where people get stuck
- Assuming only the receiving workspace gets notified; both the source and destination workspaces receive deliveries sharing the same event ID.
- Failing to verify request signatures, leaving your webhook endpoint open to spoofed data.
- Expecting immediate read consistency after a transfer, since workspace project lists may take a brief moment to reflect the change.
The short version, steps, decoder and prompt on this page are written automatically from Lovable's own documentation and can lag or misread it. The official page is always the authority.