Getting Started
Getting Started with Web Hook Box
This guide will walk you through the basics of setting up and using Web Hook Box for testing and debugging your webhook integrations.
Create an Account
Sign up for a Web Hook Box account to get started with your webhook testing journey.
Learn MoreCreate a Webhook
Generate a unique webhook URL that you can use to receive HTTP requests.
Learn MoreCreating Your Account
Getting started with Web Hook Box is simple:
-
Visit the Sign Up Page
Navigate to our registration page to create a new account.
-
Choose Your Authentication Method
You can sign up using your email address and password or use a social login option like Google or GitHub.
-
Verify Your Email
If you sign up with email, you'll need to verify your email address by clicking the link in the confirmation email we send you.
-
Complete Your Profile
While optional, completing your profile helps us provide a better experience and allows us to notify you of important updates.
Pro Tip
After creating your account, take a moment to explore the dashboard and familiarize yourself with the layout. This will make it easier to navigate as you start using the platform.
Creating Your First Webhook
Once you've created your account, you can create your first webhook:
-
Navigate to the Dashboard
After logging in, you'll land on your dashboard. This is where you'll manage all your webhooks.
-
Click "Create Webhook"
Look for the "Create Webhook" button on your dashboard and click it to start the creation process.
-
Configure Your Webhook (Optional)
You can provide a description for your webhook to help you identify it later. You can also configure advanced settings like:
- Custom responses
- Request forwarding
- Authentication requirements
Don't worry, you can always change these settings later.
-
Save Your Webhook
Click "Create" to generate your unique webhook URL. This URL will be used to receive HTTP requests.
Your Webhook URL
Your webhook URL will look something like this:
https://webhookbox.com/hook/abc123def456ghi789
This URL is unique to your webhook and won't change unless you regenerate it. You can copy it to your clipboard directly from the dashboard.
Testing Your Webhook
Now that you have your webhook URL, you can start using it to receive webhook requests:
To test your webhook with a third-party service:
- Go to the third-party service that supports webhooks (e.g., GitHub, Stripe, Shopify)
- Find their webhook settings (often in a "Settings," "Integrations," or "Webhooks" section)
- Add a new webhook and enter your Web Hook Box URL
- Configure any other required settings (e.g., events to trigger the webhook)
- Save the webhook configuration
The third-party service will now send HTTP requests to your webhook URL whenever the configured events occur.
You can also manually test your webhook using cURL:
# Send a GET request
curl https://webhookbox.com/hook/your-webhook-id
# Send a POST request with JSON data
curl -X POST \
-H "Content-Type: application/json" \
-d '{"key": "value", "event": "test"}' \
https://webhookbox.com/hook/your-webhook-id
If you're developing an application that sends webhooks, you can use your Web Hook Box URL during development:
// Node.js example
const axios = require('axios');
async function sendWebhook() {
try {
await axios.post('https://webhookbox.com/hook/your-webhook-id', {
event: 'order.created',
data: {
order_id: '12345',
customer: 'John Doe',
total: 99.99
}
});
console.log('Webhook sent successfully');
} catch (error) {
console.error('Error sending webhook:', error);
}
}
sendWebhook();
Viewing Webhook Requests
Once your webhook starts receiving requests, you can view them in your dashboard:
-
Go to Your Dashboard
Navigate to your Web Hook Box dashboard and find the webhook you created.
-
Click on the Webhook
Click on the webhook to view its details page, which includes a list of all received requests.
-
Explore Request Details
Click on any request to view its detailed information, including:
- HTTP method (GET, POST, etc.)
- Headers
- Query parameters
- Request body
- Timestamp
Real-Time Notifications
Web Hook Box provides real-time notifications when your webhook receives new requests. Keep your dashboard open to see requests as they arrive.
Next Steps
Now that you've set up your first webhook and started receiving requests, here are some next steps to explore:
Customize Your Webhook
Learn how to configure custom responses, add headers, and modify status codes for your webhook.
View GuideRequest Forwarding
Forward incoming webhook requests to your local or production environment for end-to-end testing.
View GuideReplay Requests
Learn how to replay webhook requests to test your endpoint's behavior without waiting for new events.
View GuideAPI Integration
Explore our API to programmatically create and manage webhooks in your workflows.
View API Docs