Webhooks
Webhooks allow your application to receive real-time notifications when events occur in PostCo, eliminating the need for continuous polling and enabling instant responses to return order status changes.
Webhooks are currently unavailable. This feature is in development and will be available soon. Contact [email protected] to express interest or discuss your use case.
When webhooks become available, PostCo will send HTTP POST requests to your configured endpoint whenever specific events occur—like when a return order's status changes or a shipping label is generated. This event-driven approach reduces API calls, improves responsiveness, and simplifies your integration architecture.
Planned webhook events
When webhooks launch, we're planning to support these event types:
- Name
return_order.status_changed- Description
Triggered when a return order transitions between statuses (pending → reviewed → received → completed, etc.). Use this to sync your warehouse management system, trigger customer notifications, or update internal dashboards.
- Name
shipment.label_created- Description
Fired when a shipping label is generated for a return. Useful for alerting customers that their return label is ready or triggering automated email flows with label instructions.
- Name
shipment.tracking_updated- Description
Sent when carrier tracking information updates (package picked up, in transit, delivered, etc.). Keep customers informed about their return's journey without manual status checks.
These events will cover the most common integration scenarios, from automated warehouse operations to real-time customer communication. If you have specific use cases that require additional events, we'd love to hear about them.
Get notified when webhooks launch
Webhooks are currently unavailable, but we're actively developing this feature. If webhooks are important for your integration, we want to understand your use case:
- What events do you need? Let us know which status changes or updates matter most for your workflow
- What's your use case? Describe how webhooks would improve your integration (e.g., "Automatically notify customers via SMS when return is received")
- When do you need it? Share your timeline so we can prioritize development
Contact our team at [email protected] to express interest in webhooks or discuss your specific requirements. Your input directly influences our roadmap and helps us build the webhook functionality that best serves your needs.