> For the complete documentation index, see [llms.txt](https://easy-space.gitbook.io/easy-space-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://easy-space.gitbook.io/easy-space-docs/space-settings/integrations.md).

# Integrations

## Overview

Integrations allow you to connect your coworking space with third-party services to:

* **Automate Workflows:** Automatically trigger actions when events occur in your space
* **Sync Data:** Keep your external systems updated with real-time information
* **Accept Payments:** Process payments through various payment providers
* **Monitor Activities:** Get notifications about member activities, bookings, and payments

***

## Webhooks

Webhooks enable real-time communication between your space and external applications by sending HTTP requests when specific events occur.

## What Are Webhooks?

Webhooks are HTTP callbacks that automatically send data to external URLs when events happen in your space. For example:

* When a member joins, a webhook can notify your CRM system
* When a payment is processed, a webhook can update your accounting software
* When a booking is made, a webhook can send notifications to your team

## Setting Up Webhooks

## Creating a Webhook

1. **Navigate to Webhooks:** Go to **Space Settings > Integrations > Webhooks**
2. **Click "Add Webhook":** Opens the webhook creation form
3. **Configure Your Webhook:**
   * **Name:** Give your webhook a descriptive name (e.g., "CRM Integration")
   * **URL:** The endpoint URL where data should be sent
   * **Secret:** A secure key for validating webhook authenticity
   * **Events:** Select which events should trigger the webhook
   * **Headers:** Optional custom HTTP headers
4. **Save Webhook:** Click "Create Webhook" to activate it

## Available Events

You can subscribe to various events that occur in your space:

* Member registration and profile updates
* Payment processing and subscription changes
* Booking creation, modification, and cancellation
* Check-in and check-out activities
* Membership plan changes

## Managing Webhooks

## Webhook Status

* **Active:** Webhook is enabled and will send notifications
* **Inactive:** Webhook is disabled and won't send notifications
* **Toggle Status:** Use the Enable/Disable button to control webhook activity

## Testing Webhooks

* **Test Function:** Send a test event to verify your webhook endpoint is working correctly
* **Delivery Stats:** View recent delivery success and failure rates
* **Monitoring:** Track successful and failed deliveries to ensure reliability

## Webhook Actions

* **Enable/Disable:** Control whether the webhook sends notifications
* **Test:** Send a test payload to verify functionality
* **Delete:** Permanently remove the webhook (cannot be undone)

## Webhook Security

## Authentication

* **Secret Key:** Each webhook includes a secret key for validating requests
* **Headers:** Add custom authentication headers if required by your endpoint
* **HTTPS:** Always use secure HTTPS URLs for webhook endpoints

## Best Practices

* **Validate Signatures:** Always verify webhook signatures using the secret key
* **Handle Failures:** Implement retry logic for failed webhook deliveries
* **Monitor Performance:** Regularly check delivery statistics for issues

***

## Payment Integrations

## PayPal Integration

PayPal integration enables you to:

* **Accept Global Payments:** Process payments from members worldwide
* **Automate Subscriptions:** Handle recurring membership payments automatically
* **One-time Payments:** Process bookings, services, and product purchases
* **Transaction History:** View detailed payment records in your PayPal dashboard

## Setting Up PayPal

1. **Access PayPal Settings:** Go to **Space Settings > Integrations**
2. **Click "Configure PayPal":** The organization owner or a space **Manager** can open provider settings
3. **Copy API Credentials:** In the PayPal Developer Dashboard, open your app and copy its Client ID and Client Secret
4. **Verify and Save:** Enter both values, verify them, choose availability and any processing fee, then save
5. **Verify Status:** Status should show as "Active" when successfully connected

Easy Space never displays a saved Client Secret again. When editing an existing connection, leave the secret field blank to keep the current value or enter a new secret to rotate it. Revoke the old value in PayPal after a successful rotation.

## Stripe Integration

Stripe enables you to process card payments for memberships, room bookings, products, and more. For **Recurring Plan** memberships, Stripe Connect offers an extra benefit:

* **Automatic renewals:** When members pay by card through the Members App, their card can be saved for future renewals. Each month, the system charges the saved card automatically on the renewal date—members don't need to visit the app or complete checkout again.
* **Failed charges:** If an automatic charge fails (expired card, insufficient funds, etc.), the member receives an email asking them to update their payment method. The renewal appears as "Payment Pending" until they complete payment.

## Other Payment Providers

Additional payment integrations may be available depending on your plan and region. Check the Integrations page for currently supported payment processors.

***

## Integration Management

## Monitoring Integrations

* **Status Overview:** View the current status of all connected integrations
* **Activity Logs:** Monitor recent integration activity and delivery attempts
* **Error Handling:** Identify and resolve integration issues quickly

## Troubleshooting Common Issues

## Webhook Delivery Failures

* **Check URL:** Webhook destinations must be public HTTPS URLs; local, private-network, loopback, link-local, and redirect targets are rejected
* **Verify Authentication:** Confirm secret keys and headers are properly configured
* **Review Logs:** Check delivery statistics for error patterns
* **Test Endpoint:** Use the test function to verify webhook functionality

## Payment Integration Issues

* **Account Status:** Verify your payment provider account is active and in good standing
* **Permissions:** Ensure proper permissions are granted during the connection process
* **Regional Restrictions:** Check if the payment provider supports your location

## Best Practices

## Security

* **Regular Reviews:** Periodically review and update integration settings
* **Access Control:** Limit integration management to trusted team members
* **Monitoring:** Set up monitoring for critical integrations

## Performance

* **Optimize Endpoints:** Ensure webhook endpoints respond quickly (under 30 seconds)
* **Handle Failures:** Implement proper error handling and retry mechanisms
* **Resource Planning:** Consider the impact of high-volume webhook traffic