Propstack Newsletter Sign-Up

With WP-ImmoMakler PLUS, visitors to your website can sign up directly for your Propstack newsletter. The double opt-in process — including the confirmation email and link activation — is handled entirely by Propstack. Sign-up can be embedded in four ways: in the built-in contact form, via a shortcode, in page builders, and in WPForms forms.

Note

This feature requires an active Propstack connection with an API key that you created in Propstack using the WP-ImmoMakler template — it always contains all required permissions. For instructions on creating the key, see Creating a Propstack API Key.

Requirements

• WP-ImmoMakler PLUS PLUS
• Propstack connection set up (API key in your website’s backend (wp-admin) under WP-ImmoMakler → Software/Portals → Propstack)
• API key created using the Propstack template WP-ImmoMakler. If the key was created without this template, it needs read access to Brokers, Snippets, and Client statuses (API v2) as well as write access to contacts and messages (API v1) — see API Key Permissions
• The Propstack user selected as sender is connected to a mailbox in Propstack — only then can Propstack send the double opt-in email

Setup

1. Create an email template in Propstack

   The double opt-in process is triggered by Propstack: WP-ImmoMakler submits the contact data, Propstack sends the confirmation email, and activates the newsletter consent after the link is clicked.

   In Propstack, go to Administration → Snippets and create a new snippet. The template must contain the variable {{ kontakt_link }} — it generates the confirmation link and, when clicked, automatically activates the “Contact allowed”, “Property mailings requested”, and “Newsletter requested” flags on the contact record.

   Propstack recommends the following template as a starting point:

   Subject: Please confirm your newsletter subscription
   
   {{ anrede }}
   
   Thank you for your interest in our newsletter.
   
   To complete your registration, please confirm by clicking the following
   activation link that you have signed up yourself for the free newsletter
   and would like to be informed by {{ konto.name }} via email about news
   in the property market.
   
   {{ kontakt_link }}
   
   After clicking the link, you will be informed in a browser window about
   the successful activation.
   
   You may unsubscribe from the newsletter at any time. You can let us know
   personally or unsubscribe yourself via a link in our newsletter.

   Multilingual website

   On a multilingual website you can create a text snippet containing texts for several languages. WP-ImmoMakler transmits the language when the contact is created, that is, before Propstack sends the double opt-in email. The contact’s language is therefore already set when Propstack evaluates the snippet.

   The language used is that of the page on which the visitor signs up (with WPML or Polylang); for the contact form, the language of the requested property is the fallback. Without a multilingual plugin, it is the language of your website.

   If someone signs up who already exists in Propstack as a contact with a language, the contact keeps that language. The double opt-in email then appears in that language, even if the visitor signed up on a page in a different language. If no language is stored for the existing contact yet, it receives the language of the signup.

   Propstack selects the text via the contact’s language (kontakt.sprache). In the text snippet, also add a text without a language condition, introduced with else. Otherwise the subject and text stay empty when a contact has no language, or a language for which the text snippet contains no text, for example a contact you created by hand in Propstack. This applies to the subject just as much as to the text:

   {% if kontakt.sprache == "es" %}
   Por favor, confirme su suscripción al boletín
   {% elsif kontakt.sprache == "en" %}
   Please confirm your newsletter subscription
   {% else %}
   Bitte bestätigen Sie Ihre Newsletter-Anmeldung
   {% endif %}

2. Global settings in WP-ImmoMakler

   Navigate in your website’s backend (wp-admin) to WP-ImmoMakler → Software/Portals → Propstack and scroll to the Newsletter Sign-Up section.

   

   Field	Description
   Newsletter Sign-Up: Sender	The Propstack user from whom the confirmation email is sent. This user must be connected to a mailbox in Propstack.
   Newsletter Sign-Up: Email Template	The snippet from Step 1.
   Newsletter Sign-Up: Contact Status	The status that newly created newsletter contacts receive in Propstack. Most accounts don’t need this — leave the field on “No status” in that case. If your Propstack account requires a status, Propstack rejects the sign-up with the message “Client status muss ausgewählt sein”; in that case, select a status here. You manage your statuses in Propstack under Administration → Contact Settings.
   Show newsletter opt-in in contact form	Displays an additional newsletter checkbox in the built-in property contact form (see below).

   Sender needs a connected mailbox

   Propstack sends the double opt-in email through the mailbox of the user you select under Newsletter Sign-Up: Sender. If no mailbox is connected to that user in Propstack, Propstack cannot send the double opt-in email: the contact is created but receives no confirmation email and therefore cannot complete the newsletter sign-up. Select a user with a connected mailbox, or first connect a mailbox to the desired user in Propstack.

   Tip

   The dropdowns remain empty until you have saved an API key and reloaded the page. If a red notice appears reading “Your API key is missing the following permissions”, the API key is missing the Brokers, Snippets, or Client statuses permission. In that case, create a new key in Propstack under Administration → Interfaces → API Keys using the WP-ImmoMakler template and use it to replace the previous one — the template always contains all required permissions. Alternatively, add the missing permissions to the existing key.

Choose your integration

Contact form (built-in)

If you enabled Show newsletter opt-in in contact form in the previous step, an optional checkbox appears in the built-in property contact form below the other checkboxes:

“I would like to receive regular updates on news in the property market.”

If a visitor ticks this checkbox and submits the form, WP-ImmoMakler creates the contact in Propstack and sends the confirmation email. The actual contact enquiry is not affected.

Shortcode

The shortcode [immomakler-propstack-newsletter] embeds a standalone newsletter sign-up form on any page or widget. PLUS

[immomakler-propstack-newsletter]

Available attributes:

Attribute	Default	Description
show_name_fields	0	Set to 1 to display first name and last name fields
newsletter_consent_label	(default text)	Custom label for the consent checkbox

Page builders

All supported page builders provide a WP-ImmoMakler element or widget for the newsletter form: PLUS

Builder	Element / Widget
Gutenberg	Block WP-ImmoMakler Propstack Newsletter
Elementor	Widget Propstack Newsletter
Divi 4	Module Propstack Newsletter
WPBakery	Element Propstack Newsletter
Bricks	Element Propstack Newsletter
Oxygen	Element Propstack Newsletter

The elements offer the same options as the shortcode (show/hide name fields, custom consent label).

WPForms

With the WPForms plugin you can integrate newsletter sign-up into an existing form or create a standalone newsletter form. PLUS

Adding a newsletter opt-in to an existing form

Add a Checkboxes field with one option to your form (e.g. “I would like to subscribe to the newsletter”) or use the GDPR field. Then open Settings → General → Advanced in the form editor and scroll to the WP-ImmoMakler: Propstack Newsletter section.

Field	Description
Activate Propstack newsletter sign-up	Enables the feature for this form.
Consent checkbox	The individual checkbox option whose activation triggers the double opt-in email.
Email field	The form field containing the email address.
First name field (optional)	Text field or WPForms name field with the first name.
Last name field (optional)	Text field or WPForms name field with the last name.
Salutation field (optional)	Dropdown or multiple-choice field with the salutation. Propstack knows the salutations Mr and Mrs: WP-ImmoMakler recognises the choices “Herr” and “Frau” as well as “Mr”, “Mrs”, “Ms”, “Monsieur”, “Madame”, “Señor” and “Señora”. For any other choice, such as “diverse” or “prefer not to say”, the contact is created without a salutation.

The double opt-in email is only sent when the selected consent checkbox has been ticked.

Note

For a combined WPForms name field (type Name, format First Last), WP-ImmoMakler automatically reads the respective part — you can select the same field in both dropdowns.

Standalone newsletter form (without contact email)

To create a form that exclusively sends the double opt-in email: set up the form as described above, then delete all entries under Settings → Notifications. WPForms will then send no notification email; WP-ImmoMakler will only send the confirmation email when the consent checkbox is ticked.

Process after submission

Regardless of the integration method, WP-ImmoMakler performs the following steps when consent is given:

1. Create contact — POST /v1/contacts: Creates the contact in Propstack with email address and optionally first and last name and, if a salutation field is assigned in WPForms, the salutation (salutation). If a contact status is selected above, it is sent as client_status_id, and the visitor’s language as locale (see Multilingual website). If a contact with this email address already exists, no duplicate is created; a language stored there remains unchanged.
2. Send confirmation email — POST /v1/messages: Sends the configured email template via the mailbox of the selected sender. The contact must click the {{ kontakt_link }} for Propstack to activate the newsletter consent.

The visitor receives no additional feedback on the page — the confirmation email comes directly from Propstack.

You might also be interested in

• Connecting Propstack to WordPress
• WPForms
• Mailchimp Newsletter
• Contact Form