---
title: Custom integrations via the Events API
description: Implement your own system for sending event data to Swell
---

[Skip to content](https://support.swellcx.com/en/knowledge/custom-integrations-with-the-events-api#main-content)

English

Show submenu for translations

[Customer portal](https://support.swellcx.com/tickets?hsLang=en)

![Swell\_Logo\_Magenta.svg\]](https://support.swellcx.com/hubfs/Swell_Logo_Magenta.svg)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Customer portal](https://support.swellcx.com/tickets)
- Go to swellcx.com

 Go to swellcx.com

 Hey there! How can we help you?

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

1. [Knowledge Base](https://support.swellcx.com/en/knowledge?hsLang=en)
2. [Integrations](https://support.swellcx.com/en/knowledge/integrations?hsLang=en)

# Custom integrations via the Events API

## Implement your own system for sending event data to Swell

### Overview

**The Events API is an Enterprise feature**, which means it's applicable to larger customers who are typically managing multiple brands or business entities within Swell.

Enterprise customers can integrate directly with Swell by sending appointment event data to the Events API, where it can trigger automations configured in the Swell platform.

Here's a brief summary of the steps involved in integrating with the Events API:

- Determine which data you will need to send and how frequently (e.g. realtime, hourly batches).
- Provision client credentials for your organization using the [steps outlined below](https://support.swellcx.com/en/knowledge/custom-integrations-with-the-events-api#create-and-manage-creds).
- Design and implement a custom application that posts your event data to the Events API.
- Configure your connection by mapping brands in your data to your brands in Swell.
- Configure automations to send review invites, surveys, and other messages based on the appointment data you send.

### Technical information

Technical details about authentication and required data fields are available in the [Events API documentation](https://platform.swellcx.com/public/api/docs#post-/api/int/v1/events).

### Create and manage client credentials for the Events API

To send data to the Events API, you'll need client credentials, which your integration will use to obtain access tokens that authenticate your requests. See more technical details about authentication in our [API docs](https://platform.swellcx.com/public/api/docs#auth).

To create client credentials for your Enterprise account:

1. Log on to [https://platform.swellcx.com/](https://platform.swellcx.com/) and navigate to **Settings \> Integration Settings \> API Credentials**.
2. Select **New API Client Credentials** and create a name for your credentials.
3. Save your **Client ID** and **Client Secret** in a safe place.

Please note that the **Client Secret** is only displayed once during credential creation and cannot be recovered in in the future.

If your credentials are lost, compromised, or need to be rotated, you can delete them and create a new set at any time. Only one set of credentials is supported at a time.

Additional notes:

- Client credentials for the Events API are automatically scoped to include all brands and locations within the Enterprise account, even if these change over time.
- Any Enterprise admin user can create/delete credentials on behalf of the entire account; they are not tied to a specific user or login.

- [Best Practices](https://support.swellcx.com/en/knowledge/best-practices?hsLang=en#main-content)

    - [Survey](https://support.swellcx.com/en/knowledge/best-practices?hsLang=en#survey)
- [Onboarding](https://support.swellcx.com/en/knowledge/onboarding?hsLang=en#main-content)

    - [TCR Registration](https://support.swellcx.com/en/knowledge/onboarding?hsLang=en#tcr-registration)
- [Partner Info](https://support.swellcx.com/en/knowledge/partner-info?hsLang=en)
- [Integrations](https://support.swellcx.com/en/knowledge/integrations?hsLang=en)
- [Product Help](https://support.swellcx.com/en/knowledge/product-help?hsLang=en#main-content)

    - [Webchat](https://support.swellcx.com/en/knowledge/product-help?hsLang=en#webchat)
    - [Message](https://support.swellcx.com/en/knowledge/product-help?hsLang=en#message)
    - [Account Settings](https://support.swellcx.com/en/knowledge/product-help?hsLang=en#account-settings)
    - [People](https://support.swellcx.com/en/knowledge/product-help?hsLang=en#people)
    - [Review](https://support.swellcx.com/en/knowledge/product-help?hsLang=en#review)
    - [Campaigns](https://support.swellcx.com/en/knowledge/product-help?hsLang=en#campaigns)
- [FAQs](https://support.swellcx.com/en/knowledge/faqs?hsLang=en)
- [Release Notes](https://support.swellcx.com/en/knowledge/release-notes?hsLang=en)
- [TCR Registration](https://support.swellcx.com/en/knowledge/tcr-registration?hsLang=en)
- [Patient Experience Management](https://support.swellcx.com/en/knowledge/patient-experience-management?hsLang=en)
- [Reporting](https://support.swellcx.com/en/knowledge/reporting?hsLang=en)
- [Compliance](https://support.swellcx.com/en/knowledge/compliance?hsLang=en)
- [Employee Insights](https://support.swellcx.com/en/knowledge/employee-insights?hsLang=en#main-content)

    - [Participant Experience](https://support.swellcx.com/en/knowledge/employee-insights?hsLang=en#participant-experience)
    - [Integrations](https://support.swellcx.com/en/knowledge/employee-insights?hsLang=en#integrations)
- [Ticketing](https://support.swellcx.com/en/knowledge/ticketing?hsLang=en)
- [Automated Workflows](https://support.swellcx.com/en/knowledge/automated-workflows?hsLang=en#main-content)

    - [Automated Review Responses](https://support.swellcx.com/en/knowledge/automated-workflows?hsLang=en#automated-review-responses)
- [Segments](https://support.swellcx.com/en/knowledge/segments?hsLang=en)
- [Announcements](https://support.swellcx.com/en/knowledge/announcements?hsLang=en)

[![Copy of Swell-Magenta](https://support.swellcx.com/hs-fs/hubfs/Copy%20of%20Swell-Magenta.png?width=250&height=66&name=Copy%20of%20Swell-Magenta.png "Copy of Swell-Magenta")](https://support.swellcx.com/en/knowledge?hsLang=en)

Copyright © 2026, Swell