Step 2: Connect Beehiiv API Configuration

Define your Beehiiv publication and error alert settings in a centralized configuration node.

1. Open the Workflow Config Setup node.
2. Set beehiiv_publication_id to [YOUR_ID].
3. Set beehiiv_firstname_field_name to firstname and beehiiv_lastname_field_name to lastname.
4. Set email_alert_recipients to [YOUR_EMAIL] for error notifications.

Step 3: Set Up Payload Normalization

Transform the incoming Systeme.io payload into a clean, Beehiiv-ready structure.

1. Open the Normalize Optin Payload node.
2. Set Mode to raw.
3. Set JSON Output to the following expression: ={ "email": "{{ $('Incoming Systeme Optin Hook').item.json.body.data.contact.email }}", "first_name": "{{ $('Incoming Systeme Optin Hook').item.json.body.data.contact.fields.first_name ?? "" }}", "last_name" : "{{ $('Incoming Systeme Optin Hook').item.json.body.data.contact.fields.surname ?? "" }}", "referring_site" : "{{ $('Incoming Systeme Optin Hook').item.json.body.data.source_url.replace(/\?.*$/, '') }}", "utm_source" : "{{ $('Incoming Systeme Optin Hook').item.json.body.data.source_url.match(/[?&]utm_source=([^&]*)/)?.[1] ?? "" }}", "utm_medium" : "{{ $('Incoming Systeme Optin Hook').item.json.body.data.source_url.match(/[?&]utm_medium=([^&]*)/)?.[1] ?? "" }}", "utm_campaign" : "{{ $('Incoming Systeme Optin Hook').item.json.body.data.source_url.match(/[?&]utm_campaign=([^&]*)/)?.[1] ?? "" }}" }.

Step 4: Configure the Beehiiv Subscription Request

Send the normalized data to Beehiiv using a POST request.

1. Open the Submit Beehiiv Subscription node.
2. Set URL to =https://api.beehiiv.com/v2/publications/{{ $('Workflow Config Setup').item.json.beehiiv_publication_id }}/subscriptions.
3. Set Method to POST and Specify Body to json.
4. Set JSON Body to ={ "email": "{{ $json.email }}", "utm_source": "{{ $json.utm_source }}", "utm_medium": "{{ $json.utm_medium }}", "utm_campaign": "{{ $json.utm_campaign }}", "referring_site": "{{ $json.referring_site }}", "custom_fields": [ { "name": "{{ $('Workflow Config Setup').item.json.beehiiv_firstname_field_name }}", "value": "{{ $json.first_name }}" }, { "name": "{{ $('Workflow Config Setup').item.json.beehiiv_lastname_field_name }}", "value": "{{ $json.last_name }}" } ] }.
5. In Authentication, choose genericCredentialType and set Generic Auth Type to httpBearerAuth.
6. Ensure Header Parameters include Content-Type = application/json.

Step 5: Add Error Handling

Detect failed Beehiiv responses and alert your team by email.

1. In Evaluate Subscription Status, configure two conditions with Left Value ={{ $json.statusCode }}, Operation notEquals, and Right Value 200 and 201.
2. Open Dispatch Error Email and set Send To to ={{ $('Workflow Config Setup').item.json.email_alert_recipients }}.
3. Set Subject to Systeme.io > Beehiiv Synchronization Error.
4. Set Message to =An error occurred while calling the Beehiiv API and the workflow has stopped. Subscriber affected: {{ $('Normalize Optin Payload').item.json.email }} Error status: {{ $json.body.statusText }} ({{ $json.body.status }}) Error message: {{ $json.body.errors[0].message }} and keep Email Type as text.

Step 6: Test and Activate Your Workflow

Validate the webhook intake, Beehiiv submission, and error alerts before going live.

1. Use the Incoming Systeme Optin Hook test URL to send a sample opt-in payload from Systeme.io.
2. Confirm that Submit Beehiiv Subscription returns a 200 or 201 status code in the execution data.
3. If you force an error, verify that Dispatch Error Email sends an alert to the configured recipients.
4. Toggle the workflow Active to enable production processing.