Sign-ups from your website or system: form and API

Turning sign-ups on

Every campaign has its Form and API tab. Tick Accept sign-ups from outside and the campaign gets a 10-letter code, used by both the form and the API. If you turn them off, the code is kept: a form you’ve already pasted works again when you turn them back on.

To receive sign-ups, Secuenza has to be registered: they reach your account and from there go to the program.

The form for your website

Secuenza generates the HTML code, with no scripts, for you to paste into WordPress, Wix, Shopify or a hand-made page. You choose:

• What it asks for besides the email address (name, company, phone…) and what’s required.
• The language of its labels, which will also be the language of the contacts who arrive through it.
• The button text.
• Your privacy policy, linked from the consent checkbox. The checkbox is required.
• The thank-you page, where people go after signing up. If you leave it empty, Secuenza shows one with your name and logo.
• With basic styling or without it, if you’d rather your website styled it.

How it looks shows you the result. Click Copy the code and paste it into your page. The form has a hidden field against bots and accepts ten sign-ups per IP address every ten minutes.

The API for your system

To sign people up from your website, your shop or your CRM: a POST request to https://api.secuenza.com/v1/altas with the person in JSON and your key in the Authorization: Bearer sz_alta_… header.

Click Create the key. It’s the same for all your campaigns: keep it on your server, never in a web page, because anyone who has it can sign people up to your campaigns. If it leaks, Change the key cancels the old one.

curl -X POST https://api.secuenza.com/v1/altas \
  -H "Authorization: Bearer sz_alta_…" \
  -H "Content-Type: application/json" \
  -d '{"campana":"abcdefghjk","email":"jane@example.com","nombre":"Jane","empresa":"Northside Advisors","idioma":"en","consentimiento":true}'

Only campana (the code) and email are required. It also accepts nombre (first name), apellidos (surname), empresa (company), cargo (job title), telefono (phone), ciudad (city), pais (country), web, idioma (es, en, fr, it or de), consentimiento (true if they agreed to receive your emails) and campos, with your custom fields by their key.

It replies 202 if it received it, 400 if the address is missing or invalid, 401 if the key isn’t valid, 404 if the campaign doesn’t accept sign-ups and 429 if too many arrive in a row.

When they reach the program

Sign-ups wait in Secuenza until the program collects them: every 5 minutes while it’s sending, every hour otherwise, and when you open it. With the PC off they aren’t lost: they arrive when you switch it on. Those nobody collects within 30 days are deleted.

What happens with each sign-up

• If they weren’t a contact, they’re created with what the sign-up brings and added to the campaign. Their source says “Web form” or “Sign-up via the API”, and if they ticked the box, their consent is saved with its date.
• If they were already a contact, only what was missing is filled in and they’re added. An inactive contact becomes active again.
• They aren’t added if they unsubscribed, their address doesn’t exist, they marked an email as spam or they’re on the suppression list. For people who asked for their data to be deleted, not even the address is saved.
• In the free version, a sign-up that doesn’t fit within the contact limit is recorded as “Doesn’t fit in the free version”.

Latest sign-ups, on the same tab, shows the ones that have arrived and what was done with each.

Secuenza doesn’t send a confirmation email before adding anyone (double opt-in). If you write to countries where it’s expected, such as Germany, bear it in mind: legal sending explains it.