# Connect Stripe to SendBeam

How to connect Stripe to SendBeam: what you need, the setup steps, and the code.

Via automation

For a SaaS product or a small online business, Stripe knows who your customers are before anything else does. Connecting it to SendBeam adds each new customer as a contact, so onboarding emails and customer-only updates start from the moment someone pays.

## Before you start

- An account with Stripe
- An n8n, Zapier or Make account
- A SendBeam API key, or a form ID

## Set it up

1. **Pick your automation tool.** n8n with the official SendBeam node, Make or Zapier. Each connects to Stripe with its own trigger, shown below.
2. **Create an API key.** Settings → API keys in SendBeam, with contacts:write, and lists:write if the workflow adds people to a list. The full key is shown once. To send SendBeam events out instead, add an endpoint under Settings → Webhooks.
3. **Map the fields and test.** Map the fields between Stripe and SendBeam, run the workflow once with your own address, and check the result before switching it on.

## Code

### In n8n: Stripe to SendBeam

`n8n workflow`

```
1. Stripe Trigger, listening for new customers
2. SendBeam → Contact → Create or update
     Email       the customer's email from step 1
     First name  the first name, if there is one
     Source      stripe
3. SendBeam → Contact → Add to list
     Contact     By email, the same expression as step 2
     List        From list, then pick the list by name
```

Install the SendBeam node from Settings → Community nodes (n8n-nodes-sendbeam). Adding someone who is already a contact, or already on the list, succeeds, so the workflow is safe to re-run.

### In Make: Stripe to the REST API

`Make scenario`

```
Module 1: the Stripe module that watches for new events, filtered to new customers
Module 2: HTTP → Make a request
URL:          https://sendbeam.io/api/v1/contacts
Method:       POST
Headers:      x-api-key = sb_live_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY
Body type:    Raw
Content type: JSON (application/json)
Request content:
{
  "email": "{{1.email}}",
  "first_name": "{{1.first_name}}",
  "source": "stripe"
}
```

Replace {{1.email}} and {{1.first_name}} with the customer’s email and the name, mapped from module 1. A 409 answer means the contact already exists; route it to GET /api/v1/contacts?q= with the same address if you need the contact’s id.

### In Zapier: Stripe to the REST API

`Zap`

```
Trigger  Stripe → New Customer
Action   Webhooks by Zapier → POST
URL           https://sendbeam.io/api/v1/contacts
Payload type  json
Data
  email       the customer's email
  first_name  the first name
  source      stripe
Headers
  x-api-key   sb_live_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY
```

Webhooks by Zapier is available on Zapier’s paid plans. The SendBeam app for Zapier will replace this step with a Create Contact action once it is listed in Zapier’s directory.

## Things to know

- Put customers on a list of their own, separate from marketing subscribers, and tag them by plan if you send plan-specific updates.
- Only add people to a marketing list if they agreed to hear from you. Someone who only bought or booked can still get receipts and reminders through Send transactional.

[← Stripe email marketing integration](https://sendbeam.io/integrations/stripe)

---
Source: https://sendbeam.io/docs/integrations/stripe