MessageBirdSettings
| Setting | What it is |
|---|---|
| ConnectionRequired | The MessageBird connection the step signs in with. |
| Phone number or e-mailRequired | Where the code goes: a number in international format, or an e-mail address when you pick E-mail below. |
| Sender | The sender the person sees. MessageBird uses Code when you leave this as it is, and the sender must be registered for the destination country. |
| Send as | "sms" or "flash" or "tts" or "email" |
| Message | The text around the code. It must contain %token, which is where the code is written — leave it out and the person never sees the code. Empty uses MessageBird's own text. |
| Valid for (seconds) | 30 to 172801 seconds. MessageBird's own default is 30. |
| Code length | 6 to 10 digits. |
| Attempts allowed | 1 to 10. Every check spends one, right or wrong. |
| Voice | "default" or "male" or "female" |
| Language | The language the code is read out in. |
| Subject | The subject line of the e-mail. |
| Your reference | A label MessageBird echoes back. It does not stop a duplicate send. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `messagebird`) |
recipient | textits `{{ }}` must give a string |
originator | text, by default "Code"its `{{ }}` must give a string |
type | "sms" or "flash" or "tts" or "email", by default "sms" |
template | text |
timeout | number, by default 30 |
tokenLength | number, by default 6 |
maxAttempts | number, by default 1 |
voice | "default" or "male" or "female", by default "default"used when `type` is "tts" |
language | textused when `type` is "tts" |
subject | textits `{{ }}` must give a string; used when `type` is "email" |
reference | textits `{{ }}` must give a string |
Output
| Field | Type |
|---|---|
verifyIdVerification id — Check verification code needs it | string |
statusStatus (sent, expired, failed, verified) | string |
validUntilThe moment the code stops working | string |
Sample output, and the expression for each field
- status"sent"
- validUntil"2026-09-22T12:00:30Z"
- verifyId"vf-1"
Errors
When a step of this node stops a run, the run page shows a code. Look it up:
Example step
The step as a flow file holds it. Replace each value in <…>.
{
"config": {
"connection": "<connection id>",
"language": "",
"maxAttempts": 1,
"originator": "Code",
"recipient": "<phone number or e-mail>",
"reference": "",
"subject": "",
"template": "",
"timeout": 30,
"tokenLength": 6,
"type": "sms",
"voice": "default"
},
"label": "Send verification code",
"type": "messagebird.sendVerificationCode",
"version": 1
}