MessageBird
Voice & SMSAPI keyConnection test available
MessageBird: send SMS and text-to-speech voice messages, read the account balance, look numbers up (HLR), send one-time verification tokens, and keep contacts and contact groups, over the rest.messagebird.com API.
OCNORA ships 27 typed MessageBird operations. Each node has a schema-driven form, input and output tables beside its settings, and is pre-flighted by Workflow Health before your first real run. Endpoints not covered by a typed node are called at https://rest.messagebird.com through the HTTP node with the same credential.
Before you connect MessageBird
- Authentication
- API key
- Credential
- the access key, or {"access_key": "…"}
- Connection test
- Available: the stored credential can be checked against the provider when you add it. This is not a record that a test was run or passed.
What you can do with MessageBird
Operations, grouped by what they do to your data.
Create and send 6
Read and search 12
Update 2
Delete and cancel 5
Other operations 2
A sample MessageBird workflow
- 1A core triggerStart the run from a chat, form, manual, schedule, webhook, workflow trigger — no MessageBird trigger is needed.
- 2Get Balancemessagebird.get_balanceRead the account's remaining credit, so a workflow can warn before a campaign runs the balance out. Postpaid accounts always report 0.
- 3Add Contacts To Groupmessagebird.add_contacts_to_groupAdd existing contacts to a group. MessageBird accepts at most 50 contact ids in one call, so a longer list is refused here rather than silently truncated.
An outline built from this provider’s node contracts, not a recorded run. Each step’s output fields are available to the next in the field picker.
Every node below has a reference page: what it does, the connection it needs, its config fields with types, constraints and examples, and the shapes it emits.
Operations 27
- Add Contacts To GroupAdd existing contacts to a group. MessageBird accepts at most 50 contact ids in one call, so a longer list is refused here rather than silently truncated.messagebird.add_contacts_to_group
- Create ContactAdd a contact to the account's address book by phone number.messagebird.create_contact
- Create GroupCreate a contact group that an SMS send can address by id.messagebird.create_group
- Send Verification TokenSend a one-time token to a phone number or email address and return the verification object whose id the check step needs.messagebird.create_verify
- Delete ContactRemove a contact from the address book and from every group it is in.messagebird.delete_contact
- Delete GroupRemove a contact group. The contacts in it stay in the address book.messagebird.delete_group
- Delete Scheduled MessageCancel a message that is still scheduled. A message MessageBird has already handed to an operator cannot be recalled.messagebird.delete_message
- Delete VerificationInvalidate a verification token before it would otherwise expire.messagebird.delete_verify
- Get BalanceRead the account's remaining credit, so a workflow can warn before a campaign runs the balance out. Postpaid accounts always report 0.messagebird.get_balance
- Get ContactRead one contact back by id, with its group and message counts.messagebird.get_contact
- Get GroupRead one contact group back by id, with how many contacts it holds.messagebird.get_group
- Get HLRRead the most recent HLR result for a number: its status, the operator holding it, and whether it is roaming or ported.messagebird.get_hlr
- Get MessageRead one message back by id, with the delivery status MessageBird currently holds for each recipient.messagebird.get_message
- Get VerificationRead a verification object back by id to see whether it is still valid.messagebird.get_verify
- Get Voice MessageRead one voice message back by id, with its per-recipient statuses.messagebird.get_voice_message
- List ContactsList the account's contacts one page at a time.messagebird.list_contacts
- List GroupsList the account's contact groups one page at a time.messagebird.list_groups
- List MessagesList the account's message history, filtered by originator, recipient, direction, status, type, date range or a search term.messagebird.list_messages
- List Voice MessagesList the account's voice-message history, newest first, one page at a time.messagebird.list_voice_messages
- Look Up NumberValidate a phone number and read back its country, its type and its E.164, international, national and RFC3966 formats.messagebird.lookup_number
- Remove Contact From GroupTake one contact out of a group. The contact itself stays in the address book.messagebird.remove_contact_from_group
- Request HLRAsk the mobile networks whether a number is live and which operator holds it. The query is asynchronous: this returns an HLR object with status 'sent', and the answer arrives on the report URL or from the Get HLR node.messagebird.request_hlr
- Send SMSSend or schedule an SMS to one or more numbers, or to saved contact groups. MessageBird accepts the message and reports per-recipient delivery afterwards, so the output carries the sent, delivered and failed counts rather than a single success flag.messagebird.send_sms
- Send Voice MessageCall up to 50 numbers and read a text out with text-to-speech. Like an SMS send this is accepted first and delivered afterwards, so the per-recipient counts are reported rather than a single flag.messagebird.send_voice_message
- Update ContactChange the fields you name on an existing contact and leave the rest as they were.messagebird.update_contact
- Update GroupRename an existing contact group; its membership is untouched.messagebird.update_group
- Check Verification TokenCheck the token the recipient typed against a verification. The returned status is 'verified' on success and 'expired' or 'failed' when the code was late or wrong.messagebird.verify_token
MessageBird questions
- How does OCNORA authenticate with MessageBird?
- With a stored API key credential, shaped the access key, or {"access_key": "…"}. A connection test can check it when you add it.
- What can I automate with MessageBird?
- 27 typed operations, each with a reference page listing its config fields and the shapes it emits.
- What if the MessageBird operation I need is not listed?
- Call https://rest.messagebird.com from the HTTP node with the same credential, or describe the step to the AI builder, which asks our team for a typed node when one is missing.
- Are there templates that use MessageBird?
- Not yet. Start from a blank workflow, or describe the workflow to Build with AI.
- How are MessageBird calls controlled?
- Every call and every run step is audited, runs count against the execution budget, and Workflow Health pre-flights the workflow when you save it.
See your first MessageBird workflow run.
Book a technical demo. We add the connection, pick a template or describe the workflow to Build with AI, and Workflow Health checks it before it runs.