Integrations

Stripe (Payments)

Stripe powers all payment processing in Modality — ticket sales, form payments, and order management. You must connect Stripe before accepting paid tickets or payment form fields.

How to Connect Stripe

1. 1

   Navigate to Integrations

   Go to Settings → Integrations (or click Integrations in the sidebar).

2. 2

   Click "Connect" on the Stripe card

   You are redirected to Stripe's OAuth flow. Sign in to your Stripe account (or create one).

3. 3

   Authorize Modality

   Review the permissions and click "Connect." You are redirected back to Modality with a success confirmation.

4. 4

   Start accepting payments

   Stripe is now connected. Ticket sales and form payments are automatically processed through your Stripe account. Modality handles checkout session creation, webhook processing, and order fulfillment.

Email Service Providers

Connect your existing ESP to sync contacts and route campaign sends through their infrastructure. Modality supports three ESPs: Brevo, Mailchimp, and Klaviyo.

How to Connect an ESP

1. Go to Settings → Integrations and find the ESP you want to connect.
2. Click "Connect." For Brevo and Klaviyo, enter your API key. For Mailchimp, use the OAuth flow.
3. Modality validates the API key and fetches your account information (lists, audiences, templates).
4. Once connected, the ESP appears as a sending option when creating campaigns.
5. Contact sync begins automatically — new contacts in Modality are pushed to the ESP, and vice versa.

What Syncs Between Modality and Your ESP

• Contacts — new contacts and updates sync bidirectionally based on email address matching
• Lists / Audiences — Modality lists map to ESP lists or audiences. Membership changes sync in both directions.
• Subscription status — unsubscribes and bounces from the ESP are reflected in Modality
• Campaign sends — when you choose an ESP as the sending provider, Modality creates the campaign in the ESP and triggers the send

The Connector Framework

All integrations in Modality implement a shared Connector interface. This provides consistent behavior regardless of which provider you use.

Connector Interface Methods

• syncContact — push a contact to the provider with field mapping
• syncList — create or update a list/audience in the provider
• addToList — add a contact to a specific list in the provider
• removeFromList — remove a contact from a list
• sendCampaign — create and send a campaign through the provider
• getStats — fetch campaign analytics from the provider

This abstraction means you can switch ESPs without changing your automations, campaigns, or workflows. Simply disconnect one provider, connect another, and re-select it as your campaign sending target.