Connectors

Communication, Email & Calendar

MessageBird

Omnichannel messaging and voice: conversations, calls, call flows, contacts, and numbers

Signs in with: Connection fields
Runs on: Cloud or On-Prem Worker
Operations: 131
Ready-made triggers: 4

Connect MessageBird

In Neblex open Connect › Connections and click New Connection.
Search for MessageBird and give the connection a clear name.
Fill in the fields. Secret values are encrypted and never shown again.
Click Test, then Create Connection.

Field	What to enter
Access keyRequiredSecret	A live or test access key from the MessageBird dashboard (Developers > API access).

Triggers

For events that arrive as a webhook, add a Webhook trigger and enter its Webhook URL in MessageBird's webhook settings.

Event	What it does	How
Call event	Fires when a Voice Calling webhook posts a created or updated call or leg.	Receives a webhook
Conversation event	Fires when a Conversations webhook posts a created or updated conversation or message.	Receives a webhook
SMS received	Fires when MessageBird forwards an SMS received on one of the account's numbers to the flow URL set on the number.	Receives a webhook
SMS status report	Fires when MessageBird posts a sent message's delivery status to its status report URL.	Receives a webhook

Use it in a flow

Open a flow, open the node library and search for MessageBird.
Drag it onto the canvas and choose an Operation and your connection.
Map the operation's fields from earlier steps, or click Map with Matt.
Use Test this step to see what it returns, then save.

Operations

131 operations in 22 groups. Each one is a step you can add to a flow.

Account1

Get the balancegetBalance GET The account's payment type and remaining balance.

Back order8

Get a back order`getBackOrder`	GET	A placed back order's status.
Get a back order product`getBackOrderProduct`	GET	A product's prefixes, lead time and requirements.
List required documents`listBackOrderDocuments`	GET	The identity documents a back order still needs.
List required end-user details`listBackOrderEndUserDetails`	GET	The end-user details a back order needs.
Place a back order`placeBackOrder`	POST	Order up to 100 numbers of a product and prefix.
Search back order products`searchBackOrderProducts`	GET	Number products that can be back ordered, by country, features, prefix and type.
Submit end-user details`submitBackOrderEndUserDetails`	POST	Send the end-user details a back order needs, by their ids.
Upload a document`uploadBackOrderDocument`	POST	Upload one required identity document, base64 encoded.

Call11

Add a participant`addCallParticipant`	POST	Call another number into an ongoing inbound call.
Change a call's flow`updateCall`	PUT	Run a new call flow, fetched from a URL, on an ongoing call.
Disconnect a leg`deleteLeg`	DELETE	Disconnect one leg; in a two-party call this ends the call.
Get a call`getCall`	GET	One call with its status.
Get a leg`getLeg`	GET	One leg of a call with its status, duration and cost.
Hang up a call`deleteCall`	DELETE	End every leg of a call.
List a call's legs`listLegs`	GET	The inbound and outbound legs of a call, one page at a time.
List calls`listCalls`	GET	The account's calls, one page at a time.
Make a call`createCall`	POST	Place an outbound call that runs a call flow when answered.
Put a leg on hold`holdLeg`	POST	Hold a leg, optionally playing music.
Take a leg off hold`unholdLeg`	POST	Bring a held leg back into the call.

Call flow8

Add numbers to a call flow`addCallFlowNumbers`	POST	Run a call flow for inbound calls to more of the account's numbers.
Create a call flow`createCallFlow`	POST	Create the steps (say, play, transfer, record, pause, fetch call flow, hang up) run for a call.
Delete a call flow`deleteCallFlow`	DELETE	Delete a call flow.
Get a call flow`getCallFlow`	GET	One call flow with its steps.
List a call flow's numbers`listCallFlowNumbers`	GET	The numbers whose inbound calls run a call flow, one page at a time.
List call flows`listCallFlows`	GET	The account's call flows, one page at a time (page; pagination.pageCount is the number of pages).
Replace a call flow's numbers`replaceCallFlowNumbers`	PUT	Set exactly which numbers run a call flow for inbound calls.
Update a call flow`updateCallFlow`	PUT	Replace a call flow's steps or recording setting.

Contact5

Create a contact`createContact`	POST	Add a contact with its number, name and four custom fields.
Delete a contact`deleteContact`	DELETE	Delete a contact.
Get a contact`getContact`	GET	One contact.
List contacts`listContacts`	GET	The account's contacts.
Update a contact`updateContact`	PATCH	Change a contact's number, name or custom fields.

Conversation10

Archive or reopen a conversation`updateConversation`	PATCH	Set a conversation's status.
Get a conversation`getConversation`	GET	One conversation with its contact and channels.
Get a message`getConversationMessage`	GET	One conversation message with its status.
Get messages by id`listMessagesByIds`	GET	Several conversation messages at once, optionally only those after a time.
List a contact's conversations`listContactConversations`	GET	The conversations of one contact, one page at a time.
List a conversation's messages`listConversationMessages`	GET	The messages of a conversation, one page at a time.
List conversations`listConversations`	GET	Conversations with the newest messages first, by id or status, one page at a time (limit and offset; totalCount is the total).
Reply in a conversation`replyToConversation`	POST	Send a message in an existing conversation, optionally on another channel.
Send a message`sendConversationMessage`	POST	Send a message on a channel (WhatsApp, SMS, Messenger, Telegram, LINE, email and others); an existing conversation with the recipient is resumed.
Start a conversation`startConversation`	POST	Start a conversation with a contact by sending its first message.

Conversation webhook5

Create a webhook`createConversationWebhook`	POST	Have conversation and message events posted to a URL.
Delete a webhook`deleteConversationWebhook`	DELETE	Delete a conversation webhook.
Get a webhook`getConversationWebhook`	GET	One conversation webhook.
List webhooks`listConversationWebhooks`	GET	The conversation webhooks, one page at a time.
Update a webhook`updateConversationWebhook`	PATCH	Change a webhook's URL, events, status or settings.

File3

Delete a file`deleteFile`	DELETE	Delete a stored file.
Download a file`getFile`	GET	A stored file's contents.
Upload a file`uploadFile`	POST	Store a file of up to 100 MB to send with Conversations messages.

Group8

Add contacts to a group`addGroupContacts`	PUT	Add up to 50 contacts to a group.
Create a group`createGroup`	POST	Create a contact group.
Delete a group`deleteGroup`	DELETE	Delete a group; its contacts are kept.
Get a group`getGroup`	GET	One contact group.
List a group's contacts`listGroupContacts`	GET	The contacts in a group.
List groups`listGroups`	GET	The account's contact groups.
Remove a contact from a group`removeGroupContact`	DELETE	Take a contact out of a group.
Rename a group`updateGroup`	PATCH	Change a group's name.

HLR3

Get an HLR lookup`getHlr`	GET	One HLR lookup with its network details.
List HLR lookups`listHlr`	GET	The account's HLR lookups.
Request an HLR lookup`requestHlr`	POST	Ask the home network whether a number is reachable; the result arrives later.

Lookup3

Get a number's HLR`getLookupHlr`	GET	The latest HLR lookup of a number.
Look up a number`lookupNumber`	GET	A number's type, country and formats (E.164, international, national, RFC 3966).
Request an HLR for a number`requestLookupHlr`	POST	Start an HLR lookup through the Lookup API.

MMS3

Get an MMS`getMms`	GET	One MMS with each recipient's status.
List MMS`listMms`	GET	The account's MMS messages.
Send an MMS`sendMms`	POST	Send a multimedia message with text and media links (US and Canada numbers).

Number6

Buy a number`purchaseNumber`	POST	Buy a number found by the search.
Cancel a number`cancelPurchasedNumber`	DELETE	Release a number from the account.
Get a number`getPurchasedNumber`	GET	One of the account's numbers.
List your numbers`listPurchasedNumbers`	GET	The numbers the account owns, by type, feature, tags, region or locality, one page at a time (limit and offset; totalCount is the total).
Search numbers to buy`searchAvailableNumbers`	GET	Numbers available in a country by pattern, features and type.
Tag a number`updatePurchasedNumber`	PATCH	Set the tags that group or label a number.

Number pool8

Add numbers to a pool`addPoolNumbers`	POST	Attach up to 1,000 numbers to a pool.
Create a number pool`createNumberPool`	POST	Create a pool of numbers for a service, such as random caller ids.
Delete a number pool`deleteNumberPool`	DELETE	Delete a pool and detach its numbers.
Get a number pool`getNumberPool`	GET	One number pool.
List a pool's numbers`listPoolNumbers`	GET	The numbers in a pool, one page at a time (limit and offset).
List number pools`listNumberPools`	GET	The account's number pools by name or service, one page at a time (limit and offset).
Remove numbers from a pool`removePoolNumbers`	DELETE	Detach numbers from a pool.
Update a number pool`updateNumberPool`	PUT	Rename a pool or change its configuration.

Omnichannel contact13

Add a contact identifier`addContactIdentifier`	POST	Link a phone number, email address or channel id to a contact.
Create an omnichannel contact`createContactV2`	POST	Create a contact profile used across every channel.
Create or update an omnichannel contact`upsertContactV2`	POST	Find a contact by its identifiers and update it, or create it when none matches.
Delete an omnichannel contact`deleteContactV2`	DELETE	Delete a contact with its profiles, conversations and their messages.
Get a contact identifier`getContactIdentifier`	GET	One identifier of a contact.
Get an import's status`getContactImportStatus`	GET	Whether a contact import is queued, in progress, completed or failed.
Get an omnichannel contact`getContactV2`	GET	One contact with its identifiers and channel profiles.
Import contacts`importContacts`	POST	Import up to 100,000 contacts from a CSV file (columns phone, email, firstName, lastName, displayName and custom: ).
List a contact's identifiers`listContactIdentifiers`	GET	The phone numbers, email addresses and channel ids of a contact.
List omnichannel contacts`listContactsV2`	GET	Contacts by id, channel, exact identifier or status, one page at a time (limit and offset; totalCount is the total).
Merge omnichannel contacts`mergeContactsV2`	POST	Merge one contact into another, with its conversations.
Remove a contact identifier`deleteContactIdentifier`	DELETE	Remove an identifier and the channel profiles linked to it.
Update an omnichannel contact`updateContactV2`	PATCH	Change a contact; languages are replaced and attributes merged.

Recording7

Delete a recording`deleteRecording`	DELETE	Delete a recording.
Download a recording`downloadRecording`	GET	A recording's WAV file.
Get a recording`getRecording`	GET	One recording's details and file link.
Get a transcription`getTranscription`	GET	One transcription with its status and file links.
List a leg's recordings`listRecordings`	GET	The recordings of a leg, one page at a time (limit and offset).
List a recording's transcriptions`listTranscriptions`	GET	The transcriptions of a recording.
Transcribe a recording`createTranscription`	POST	Request a text transcription of a recording; it completes asynchronously.

SMS5

Delete an SMS`deleteSms`	DELETE	Delete an SMS, which also cancels it when it is still scheduled.
Get an SMS`getSms`	GET	One SMS with each recipient's delivery status.
List SMS`listSms`	GET	Sent and received SMS, filtered by sender, direction, type or status (for example scheduled).
Send an SMS`sendSms`	POST	Send an SMS to up to 50 numbers or to contact groups, now or at a scheduled time.
Send SMS in a batch`sendSmsBatch`	POST	Send up to 100 different SMS messages, each to its own recipients, in one request.

Verify5

Check a verification code`checkVerificationCode`	GET	Check the code the user entered.
Delete a verification`deleteVerification`	DELETE	Delete a verification, which also invalidates its code.
Get a verification`getVerification`	GET	One verification with its status.
Get a verification email`getVerificationEmail`	GET	The status of a verification's email message.
Send a verification code`createVerification`	POST	Send a one-time code by SMS, flash SMS, voice call or email.

Voice message3

Get a voice message`getVoiceMessage`	GET	One voice message with each recipient's status.
List voice messages`listVoiceMessages`	GET	The account's voice messages.
Send a voice message`sendVoiceMessage`	POST	Call numbers and read a text to them with text to speech.

Voice number4

Create a number webhook`createNumberWebhook`	POST	Have call events of one number posted to a URL.
Get a number's call flow`getNumberCallFlow`	GET	The call flow that inbound calls to a number run.
List a number's webhooks`listNumberWebhooks`	GET	The webhooks attached to one number.
List voice numbers`listVoiceNumbers`	GET	The account's voice-enabled numbers, one page at a time.

Voice webhook5

Create a webhook`createVoiceWebhook`	POST	Have call and leg events posted to a URL.
Delete a webhook`deleteVoiceWebhook`	DELETE	Delete a voice webhook, including one attached to a number.
Get a webhook`getVoiceWebhook`	GET	One voice webhook.
List webhooks`listVoiceWebhooks`	GET	The account's voice webhooks.
Update a webhook`updateVoiceWebhook`	PUT	Change a voice webhook's URL or token.

WhatsApp template7

Create a WhatsApp template`createWhatsAppTemplate`	POST	Submit a WhatsApp message template for approval.
Delete a template language`deleteWhatsAppTemplateLanguage`	DELETE	Delete one language version of a template.
Delete a WhatsApp template`deleteWhatsAppTemplates`	DELETE	Delete a template in every language.
Get a template's languages`listWhatsAppTemplatesByName`	GET	Every language version of a template.
Get a WhatsApp template`getWhatsAppTemplate`	GET	A template in one language with its approval status.
List WhatsApp templates`listWhatsAppTemplates`	GET	The account's templates, one page at a time (limit and offset; totalCount is the total).
Update a WhatsApp template`updateWhatsAppTemplate`	PUT	Replace the components of a template in one language.