FlowRunner
Pricing
Theme

Mocean

Messaging

Send SMS, run two-factor verification flows, look up carrier and portability data, and monitor account balance and pricing through the MoceanAPI network.

7 actions available
A workflow needs to reach a list of recipients by SMS
Agent gathers the recipient numbers and message text
Agent runs Number Lookup to drop invalid or ported numbers
Agent calls Get Balance to confirm prepaid funds cover the send
Agent sends the message with Send SMS to the validated recipients
Agent records the per-recipient result and remaining balance
A bulk send that would draw down the prepaid balance waits for approval

What This Integration Enables

An agent can send transactional or notification SMS to one or many recipients, deliver one-time PINs for two-factor login, and confirm the code a user entered. It can validate a number and detect its carrier or whether it has been ported before messaging, and monitor prepaid balance and per-country pricing to control spend. The verification actions cover the full loop: Send Verification Code, Resend Verification Code when the first message does not arrive, and Check Verification Code to confirm the input.

Without FlowRunner

Sends to dead numbers Messages go to ported or invalid numbers and quietly fail
Spend runs unchecked A large send drains prepaid credit before anyone notices
Manual PIN handling Someone copies verification codes between systems by hand

With FlowRunner

Filtered recipient list Number Lookup removes invalid and ported numbers before the send
Balance checked first The agent confirms prepaid funds before it commits to a batch
Verification in flow Send, resend, and check PIN steps run inside the workflow

Use Case Scenarios

Phone-based access verification

A new member joins a workspace and needs to prove a phone number before access is granted. The agent calls Send Verification Code to deliver a PIN, and if the member reports no message, Resend Verification Code reuses the same request. Check Verification Code confirms the code they enter. Access is granted only on a matching code, and the whole loop runs without a person in the middle.

Clean-list SMS notifications

An agent pulls a contact list from a source system, then runs Number Lookup on each number to filter out invalid or ported entries. It sends the notification with Send SMS only to the validated recipients. The list stays clean, and the send does not waste credit on numbers that cannot receive it.

Balance-aware bulk send

A workflow prepares a notification to a large recipient set. Before sending, the agent calls Get Balance and Get Pricing to estimate the spend. Because the batch would draw down a meaningful share of the prepaid balance, the agent stops at the human-in-the-loop step and asks for approval before it sends.

Human-in-Loop Highlight

Prepaid credit is finite, and a bulk SMS send spends it all at once. Before the agent runs a batch large enough to draw down the prepaid balance past a set line, it pauses and routes the decision to an operator: "This send covers 1,200 validated recipients and will spend an estimated portion of the prepaid balance. Approve the send or trim the list?" This is FlowRunner's human-in-the-loop pattern, where the agent stops on its own, shows the audience and the spend, and resumes when the human answers. Single verification PINs and one-off texts send without interruption. Batches that move real money get a human decision first.

Agent processes routinely
Detects exception requiring judgment
Clear match Continues automatically
Ambiguous Routes to human via preferred channel
Human decides
Agent resumes with decision

Agent Capabilities

7 actions

SMS

1
  • Send SMS Sends an SMS to one or more recipients in international MSISDN format, concatenating long messages automatically. Returns a per-recipient result with a status code, the receiver number, and a message ID for tracking.

Verify

3
  • Send Verification Code Starts a two-factor verification by generating a one-time PIN and delivering it by SMS, returning a request ID for confirmation. Used to begin a phone-verification step.
  • Check Verification Code Validates the PIN a user entered against a pending request using the request ID. A zero status confirms the code; anything else means a wrong or expired code.
  • Resend Verification Code Resends the PIN for an existing request, reusing the original request ID rather than starting over. Used when the recipient did not receive the first message.

Number Lookup

1
  • Number Lookup Looks up carrier and portability information for a number in real time, returning the current and original carrier and whether the number has been ported. Used to validate and route before sending.

Account

2
  • Get Balance Retrieves the current prepaid balance in the account currency. Used to confirm available funds before a send.
  • Get Pricing Retrieves per-country SMS pricing, optionally filtered to a single country. Used to estimate spend before a campaign.

Start building with Mocean

$100 in credits. No card required. Connect in minutes.