Skip to content

Twilio SMS

Pro feature

Twilio SMS is part of Formatrica Pro. The Free edition does not include it.

Send an SMS notification to your team each time a form is submitted.

Enable it

  1. In your Twilio console, note your Account SID and create an API Key (SID + Secret).
  2. Choose a sender: a Twilio phone number or a Messaging Service SID.
  3. In Formatrica, open your form → Settings → Integrations.
  4. Enable Twilio SMS and enter the credentials.
  5. Set the recipient number and, optionally, a message template.
  6. Save the form.

Settings

SettingFormatPurpose
Account SIDAC + 32 hex charsYour Twilio account identifier.
API Key SIDSK + 32 hex charsThe API key's SID (used as the auth username).
API Key SecretThe API key's secret. Stored encrypted and never shown again after saving.
Sender modeNumber / Messaging ServiceHow the SMS is sent from.
From numberE.164 (e.g. +15551234567)Required when sender mode is Number.
Messaging Service SIDMG + 32 hex charsRequired when sender mode is Messaging Service.
Recipient numberE.164The single admin number that receives the alert.
Message templatetext (max 1000)The SMS body. See placeholders below.
Regionus1 / ie1 / au1Twilio API region.

Values must be well-formed

The SIDs and phone numbers are strictly validated against Twilio's formats. A value that doesn't match (for example a phone number without the +country prefix, or a SID with the wrong prefix) is discarded on save — so if a field comes back empty after saving, check its format.

Message template

The template supports these placeholders:

  • {{form_title}} — the form's title
  • {{form_id}} — the form's numeric ID
  • {{field:field_name}} — the submitted value of a specific field

If left blank, a default message is sent. The whole-payload placeholder {{submission_json}} is deliberately not allowed in SMS (it would expand the entire submission into a text message).

How it works

  • Sends one SMS per submission through the Twilio REST API, using the region you selected. Runs in the background queue.
  • The recipient is a single fixed admin number — SMS notifications are for your team, not for replying to the submitter.
  • SMS costs money per message. If your Pro licence lapses past its grace period, sending stops automatically (your saved configuration is kept), so a lapsed licence never keeps spending your Twilio balance.

Test it

  • Submit the form and confirm the SMS arrives at the recipient number with the rendered template.