Skip to main content
All CollectionsMarketingMailings
Register mailing opt-ins from your own website
Register mailing opt-ins from your own website

Subscribe to the newsletter using an external, “hidden” interface.

Updated over 5 months ago

Stager has a great mail module which you can send targeted mailings with: those about specific events, for example. You can read how to do that here.

Marketing mailings can be sent when recipients have given permission. They can do this by checking opt-ins during the ticket ordering process or by registering themselves for the newsletter via your website.


Registration via the website is as follows:

  • Place a form on your own website which visitors can use to subscribe to a specific newsletter. Through the form, the web visitor enters an email address.

  • The form is sent to the backend of your own website. When the backend of your website receives a subscription request, it is forwarded to Stager's API. The request cannot be sent to Stager directly from the visitor's browser because (1) the Stager API token is then known to the registrant's browser, and (2) because browsers do not allow a third-party API party to be approached.

  • When the Stager API receives a subscription request, we send a welcome email to the specified email address.

  • The recipient verifies their email address by clicking on a link in the email. The registration is now complete.

  • From that moment on, the visitor can be found via Contacts and can be mailed!

Have this integrated by your website developer or system administrator.


Stager opt-in registration API details

Registering opt-ins in Stager is done with a POST request to the following endpoint:

https://[organization].stager.co/api/ticketshop/optin/register?token=[token]&email=[email]&firstname=[firstname]&lastname=[lastname]

  • ​The query parameters ([token] and [email]) must be URL-encoded, this is especially important for the email address because it contains an @ sign, which must be converted to %40.

  • Generating a new "access token" at Settings - Marketing - Opt-ins will render the old token useless.

Here is an example of an API request to register the email address dansfreak@subculture.nl from the command line with a curl:

curl -X POST 'https://yourvenue.stager.co/api/ticketshop/optin/register?token=abcdabcd-d7b1-42b9-adc8-278d12341234&email=dansfreak%40subcultuur.nl'
Did this answer your question?