Skip to main content

Documentation Index

Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt

Use this file to discover all available pages before exploring further.

Creating a user-friendly and effective opt-in form is crucial for any Email marketing strategy. This guide will help you build out different approaches for collecting email addresses. Each method caters to various user preferences and regulatory requirements. The Email collection options include:
  1. Log-in collection opt-in
  2. Newsletter sign up
  3. Coupon code promotional opt-in

​
Example Opt-in Flows

For all of these examples, you can check out a working demo available on GitHub, take a look for inspiration.
Call the Create user endpoint to create a new Email subscription record. Expected response from this endpoint:
  • 200 - success, a subscription record has been created
  • 202 - subscription record was already created

​
Log-in Collection Opt-in

In your sign-up flows, you can collect phone numbers. Make sure to include consent boxes, that are ‘un-ticked’ by default.

​
Newsletter Sign Up

Collect emails directly from your marketing website, perfect for when you want people to sign up for updates or news.

​
Coupon Code Promotional Opt-in

A coupon code promotional opt-in is a standard way to incentivize a customer to provide you with their phone number. It’s a great choice for Desktop and Mobile experiences. Because the recipients opt-in only by providing their phone number, this would not be considered best practice is some locations that require a double opt-in flow.

​
Making sure your opt-in flows are compliant

Sending Email messages is subject to regulatory oversight. Learn more at Email Regulatory Compliance.