Marker.io has introduced workspace-level webhook notifications, providing better organization and management of your webhook integrations. This guide will walk you through migrating your existing webhook project’s webhooks to the new workspace-level system.
What's new?
The new workspace-level webhook system allows you to:
Manage webhooks centrally from your workspace settings
Apply webhooks across multiple projects simultaneously
Have better control over which projects trigger webhook notifications
Migration steps
Step 1: Create a new project
Start by creating a fresh project:
Navigate to your dashboard
Click "Create Project"
Select an integration or choose to create a project without integration
Enter your project name and create your project
Step 2: Set up your widget
Configure and install the Marker.io widget on your website:
Go to your new project settings
Navigate to Widget settings
Customize your widget appearance
Copy the widget installation code
Add the widget installation code to your website
Step 3: Configure workspace webhook
Set up the webhook at the workspace level:
Go to Workspace Settings > Webhooks
Click "Create webhook"
Enter a name, your webhook URL and configure the settings
Choose your trigger events
Finish the creation of the webhook by clicking “Create webhook”
Step 3.1: Select target projects
By default, all projects in your workspace will be selected for webhook notifications:
To include all projects: Leave the default selection
To target specific projects:
Deselect "Apply to all Projects"
Use the search to find your new project
Select only the projects you want to receive webhook notifications
Step 4: Test your webhook
Automatically, Marker.io will send a sample issue webhook that contains the structure of the webhook and some sample properties.
If you want to verify that your webhook is working correctly for your projects:
Submit a test issue through your widget
Check that your webhook endpoint receives the notification
Verify the payload structure and data
Step 5: Migrate team members
Transfer all users from your legacy project to the new project:
Go to your legacy project
Note down all users from that project
Navigate to your new project
Click Manage access
Invite all the necessary users
Step 6: Go live
Once everything is configured and tested:
Update any internal documentation with the new project details
Archive or delete the legacy project (optional)
Monitor the webhook notifications to ensure smooth operation
Troubleshooting
Webhook not receiving notifications:
Verify your webhook URL is accessible
Check that the correct projects are selected
Ensure your endpoint can handle the webhook payload format
Next steps
After successful migration, you can:
Set up additional webhook endpoints for different purposes or integrations that we don’t support yet
Configure webhook filters for specific event types:
Issue created
Issue updated (coming soon)
Issue status updated (coming soon)
Issue assignee updated (coming soon)
Comment created (coming soon)
Need help with your migration? Contact our support team through the help center or reach out via the in-app chat.