---
title: Configuring Outbound Webhooks
description: "This article walks through the steps to configure outbound webhooks for the following events: client_create, client_update, subscription_create, and subscription_update on the Opus1.io platform."
---

[Skip to content](https://kb.opus1.io/configuring-outbound-webhooks#main-content)

English

Show submenu for translations

![Opus1-3-icon-color-1.png\]](https://kb.opus1.io/hs-fs/hubfs/Opus1-3-icon-color-1.png?height=50&name=Opus1-3-icon-color-1.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- Go to opus1.io

 Go to opus1.io

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [opus1io Knowledge Base](https://kb.opus1.io/?hsLang=en)
2. [Business](https://kb.opus1.io/business?hsLang=en)
3. [Integrations](https://kb.opus1.io/business?hsLang=en#integrations)

# Configuring Outbound Webhooks

## This article walks through the steps to configure outbound webhooks for the following events: client\_create, client\_update, subscription\_create, and subscription\_update on the Opus1.io platform.

This article walks through the steps to configure outbound webhooks for the following events: `client_create`, `client_update`, `subscription_create`, and `subscription_update` on the Opus1.io platform. These webhooks allow for real-time data syncing between Opus1.io and external systems, providing essential information about clients and their subscriptions.

### Prerequisites

Before configuring outbound webhooks, ensure you have the following:

- Access to the Opus1.io platform with sufficient permissions to configure webhooks.
- The URL of the external system's webhook endpoint where Opus1.io will send event data.
- Familiarity with handling webhook payloads on the receiving end.

### Supported Webhook Events

Opus1.io supports the following outbound webhook events:

1. `client_create`: Triggered when a new client is created.
2. `client_update`: Triggered when a client's information is updated.
3. `subscription_create`: Triggered when a new subscription is created.
4. `subscription_update`: Triggered when a subscription is updated.

### Outbound Webhook Configuration Process

To configure outbound webhooks for these events, follow these steps:

1. **Log into Opus1.io**: Navigate to the webhook configuration section by navigating to **Business \> Integrations \> Webhooks.**
2. **Create a New Outbound Webhook**:
   
     - Click the **+ Add Webhook** button.
     - In the **Webhook Name** field, enter a name that identifies the purpose of the webhook, e.g., `Client Creation Webhook` or `Subscription Update Webhook`.
     - Select **Outbound Webhook** as the Webhook Type.
3. **Set Trigger Type**  
     - In the **Webhook Trigger** field, select client\_create\_trigger, client\_update\_trigger, subscription\_create\_trigger, or subscription\_update\_trigger.
4. **Set the Webhook URL**:

- - In the **Webhook URL** field, enter the URL of the endpoint where the webhook payload will be sent.
    - Finally, click **Update Business** to save your Outbound Webhook.

### **Webhook Payload Structure:**

Opus1.io will send a POST request to the webhook URL with a JSON payload containing the event data. The payload structure will vary based on the event, but it will follow a consistent format for client and subscription events respectively.

- - **Client Webhook Payload** (`client_create`, `client_update`):
      
      `{ "business": "string", "id": "integer", "first_name": "string", "middle_name": "string", "last_name": "string", "email": "string", "status": "string", "tags": ["string"], "new_member_at": "datetime", "member_lost_at": "datetime", "primary_phone": "string", "street": "string", "zip_code": "string", "city": "string", "state": "string", "country": "string", "birthdate": "date", "staff_role": "string", "staff_employee_id": "string" }`
    - **Subscription Webhook Payload** (`subscription_create`, `subscription_update`):
      
       
      
      `{ "business": "string", "id": "integer", "status": "string", "client_id": "integer", "payer_id": "integer", "secondary_payer_id": "integer", "service_id": "integer", "session_id": "integer", "location_id": "integer", "primary_staff_id": "integer", "terms_accepted_at": "datetime", "created_at": "datetime", "ended_at": "datetime", "start_at": "datetime", "end_at": "datetime", "replacing_subscription_id": "integer", "replaced_by_subscription_id": "integer" }`

### Testing the Webhook

To verify the webhook is working correctly:

- Use a tool like [Webhook.site](https://webhook.site/) to inspect the payload and headers.
- Confirm that your system's endpoint is receiving and processing the data as expected.
- Opus1.io will display the status of recent webhook deliveries, including any failed attempts. Use this log for troubleshooting if needed.

#### Conclusion

By setting up outbound webhooks, Opus1.io can automatically push real-time updates about clients and their subscriptions to external systems. Make sure to test the configuration thoroughly to ensure data is being transmitted correctly and any errors are handled appropriately.

For additional help, please refer to the [Opus1.io support documentation](https://kb.opus1.io/?hsLang=en) or contact support.

- [Account & Troubleshooting](https://kb.opus1.io/account-troubleshooting?hsLang=en#main-content)

    - [General](https://kb.opus1.io/account-troubleshooting?hsLang=en#general)
    - [Login & Access](https://kb.opus1.io/account-troubleshooting?hsLang=en#login-access)
    - [Release Notes](https://kb.opus1.io/account-troubleshooting?hsLang=en#release-notes)
- [Business](https://kb.opus1.io/business?hsLang=en#main-content)

    - [General](https://kb.opus1.io/business?hsLang=en#general)
    - [Business Profile & Billing](https://kb.opus1.io/business?hsLang=en#business-profile-billing)
    - [Client Data & Forms](https://kb.opus1.io/business?hsLang=en#client-data-forms)
    - [Integrations](https://kb.opus1.io/business?hsLang=en#integrations)
    - [Locations & Rooms](https://kb.opus1.io/business?hsLang=en#locations-rooms)
    - [Self-Booking Links](https://kb.opus1.io/business?hsLang=en#self-booking-links)
    - [Terms & Conditions](https://kb.opus1.io/business?hsLang=en#terms-conditions)
- [Calendar & Scheduling](https://kb.opus1.io/calendar-scheduling?hsLang=en#main-content)

    - [General](https://kb.opus1.io/calendar-scheduling?hsLang=en#general)
    - [Batch Schedule Actions](https://kb.opus1.io/calendar-scheduling?hsLang=en#batch-schedule-actions)
    - [Calendar Notes & Display](https://kb.opus1.io/calendar-scheduling?hsLang=en#calendar-notes-display)
    - [Enrollment](https://kb.opus1.io/calendar-scheduling?hsLang=en#enrollment)
    - [Recurring & Rescheduling](https://kb.opus1.io/calendar-scheduling?hsLang=en#recurring-rescheduling)
    - [Substitutes](https://kb.opus1.io/calendar-scheduling?hsLang=en#substitutes)
- [Clients](https://kb.opus1.io/clients?hsLang=en#main-content)

    - [Account Managers & Dependents](https://kb.opus1.io/clients?hsLang=en#account-managers-dependents)
    - [Client Experience](https://kb.opus1.io/clients?hsLang=en#client-experience)
    - [Client Records](https://kb.opus1.io/clients?hsLang=en#client-records)
    - [Credits](https://kb.opus1.io/clients?hsLang=en#credits)
    - [Gift Cards](https://kb.opus1.io/clients?hsLang=en#gift-cards)
    - [Invoices](https://kb.opus1.io/clients?hsLang=en#invoices)
    - [Payments & Auto-Pay](https://kb.opus1.io/clients?hsLang=en#payments-auto-pay)
    - [Subscriptions](https://kb.opus1.io/clients?hsLang=en#subscriptions)
    - [Waitlist Notifications](https://kb.opus1.io/clients?hsLang=en#waitlist-notifications)
- [Communication](https://kb.opus1.io/communication?hsLang=en#main-content)

    - [Email & Notifications](https://kb.opus1.io/communication?hsLang=en#email-notifications)
    - [SMS](https://kb.opus1.io/communication?hsLang=en#sms)
    - [Voice](https://kb.opus1.io/communication?hsLang=en#voice)
- [Grow Your Music School](https://kb.opus1.io/grow-your-music-school?hsLang=en#main-content)

    - [Convert Prospects](https://kb.opus1.io/grow-your-music-school?hsLang=en#convert-prospects)
    - [Email Campaigns](https://kb.opus1.io/grow-your-music-school?hsLang=en#email-campaigns)
    - [Get Found & Capture Leads](https://kb.opus1.io/grow-your-music-school?hsLang=en#get-found-capture-leads)
    - [Reviews & Reputation](https://kb.opus1.io/grow-your-music-school?hsLang=en#reviews-reputation)
- [Payment Processing](https://kb.opus1.io/payment-processing?hsLang=en#main-content)

    - [General](https://kb.opus1.io/payment-processing?hsLang=en#general)
    - [Opus1 Payments (Stripe)](https://kb.opus1.io/payment-processing?hsLang=en#opus1-payments-stripe)
    - [Clover Connect (FiServ / Cardpointe)](https://kb.opus1.io/payment-processing?hsLang=en#clover-connect-fiserv-cardpointe)
- [Reporting](https://kb.opus1.io/reporting?hsLang=en#main-content)

    - [Attendance](https://kb.opus1.io/reporting?hsLang=en#attendance)
    - [Credits](https://kb.opus1.io/reporting?hsLang=en#credits)
    - [Invoices](https://kb.opus1.io/reporting?hsLang=en#invoices)
    - [Subscriptions](https://kb.opus1.io/reporting?hsLang=en#subscriptions)
    - [Transactions](https://kb.opus1.io/reporting?hsLang=en#transactions)
    - [Data Exports](https://kb.opus1.io/reporting?hsLang=en#data-exports)
- [Services](https://kb.opus1.io/services?hsLang=en#main-content)

    - [Appointments](https://kb.opus1.io/services?hsLang=en#appointments)
    - [Building Services](https://kb.opus1.io/services?hsLang=en#building-services)
    - [Cancellation](https://kb.opus1.io/services?hsLang=en#cancellation)
    - [Events](https://kb.opus1.io/services?hsLang=en#events)
    - [Optimization & Conversion](https://kb.opus1.io/services?hsLang=en#optimization-conversion)
    - [Payment Plans](https://kb.opus1.io/services?hsLang=en#payment-plans)
    - [Group Classes](https://kb.opus1.io/services?hsLang=en#group-classes)
    - [Subscription-Only](https://kb.opus1.io/services?hsLang=en#subscription-only)
- [Staff](https://kb.opus1.io/staff?hsLang=en#main-content)

    - [Availability & Self-Booking](https://kb.opus1.io/staff?hsLang=en#availability-self-booking)
    - [Calendar Sync](https://kb.opus1.io/staff?hsLang=en#calendar-sync)
    - [Onboarding & Offboarding](https://kb.opus1.io/staff?hsLang=en#onboarding-offboarding)
    - [Payroll & Compensation](https://kb.opus1.io/staff?hsLang=en#payroll-compensation)
    - [Roles & Permissions](https://kb.opus1.io/staff?hsLang=en#roles-permissions)
    - [Teacher Tools & Access](https://kb.opus1.io/staff?hsLang=en#teacher-tools-access)
    - [Time-off](https://kb.opus1.io/staff?hsLang=en#time-off)
- [Stats](https://kb.opus1.io/stats?hsLang=en#main-content)

    - [Conversions](https://kb.opus1.io/stats?hsLang=en#conversions)
    - [Client Metrics](https://kb.opus1.io/stats?hsLang=en#client-metrics)
    - [Dashboard](https://kb.opus1.io/stats?hsLang=en#dashboard)
    - [Group Class Enrollment](https://kb.opus1.io/stats?hsLang=en#group-class-enrollment)
    - [Today](https://kb.opus1.io/stats?hsLang=en#today)
    - [Utilization](https://kb.opus1.io/stats?hsLang=en#utilization)

[![Chill listening crop-3](https://kb.opus1.io/hs-fs/hubfs/Opus1-3-icon-color-2.png?width=35&height=24&name=Opus1-3-icon-color-2.png "Chill listening crop-3")](http://opus1.io)

<https://www.facebook.com/opus1.io/>

Copyright © 2025, Opus1.io