Custom Webhook Integration for Email/SMS Platforms
Skio’s Integration Webhooks let you receive real-time subscription events—perfect for email or SMS platforms. It works like our Klaviyo integration but sends events directly to your own webhook endpoi
The Skio Integration Webhook system allows you to receive real-time subscription events from our platform. This integration follows our standard event tracking system, similar to our Klaviyo integration, but with the flexibility of sending events to your own webhook endpoint.
Before you get started, Skio will set up a new integration card for your development store. Please reach out to the Skio team with the name of the store you’re using, and we’ll add the integration section so you can begin testing.
Setup Process
1. Integration Configuration
Navigate to your Skio dashboard
Go to the Integrations section
Select your brand as your integration type
Provide your webhook URL where you want to receive the events
Configure which events you want to receive by adding event triggers
2. Event Payload Structure
Each webhook event will be sent as a POST request to your endpoint with the following structure:
type WebhookPayload = {
eventName: string; // The type of event (see Events section)
eventTriggerSettings?: { // Optional settings specific to the trigger
daysBefore?: number; // For events like billing reminders
};
vendor: string; // The integration vendor (e.g., "canopy", "bloomreach")
properties: { // Event-specific properties
// Common properties included in all events
email: string;
subscriptionId?: string;
status?: string;
// ... other properties depending on the event type
};
domain: string; // Your shop's domain
}
3. Available Events
Here are the key subscription events you can receive:
Subscription Lifecycle Events
subscriptionCreated: When a new subscription is created
subscriptionCancelled: When a subscription is cancelled
subscriptionReactivated: When a cancelled subscription is reactivated
subscriptionPaused: When a subscription is paused
subscriptionUnpaused: When a subscription is unpaused
subscriptionSkipped: When a delivery is skipped
subscriptionRenewed: When a subscription renews successfully
Billing Events
billingAttemptFailed: When a billing attempt fails