> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Mocean

> Mocean enables SMS, voice, and verification services, integrating messaging capabilities into applications for multifactor authentication or customer engagement

![Mocean logo](https://mintcdn.com/composio-preview/9YPuzjEU4UlMnwGq/images/toolkits/mocean.svg?fit=max\&auto=format\&n=9YPuzjEU4UlMnwGq\&q=85\&s=1d9ebe3ea003c1c053253aa84779827f)

* **Category:** phone & sms
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 6
* **Triggers:** 0
* **Slug:** `MOCEAN`
* **Version:** 20261101\_00

## Tools

> [accordion] Query SMS Message Status V2
>
> **Slug:** `MOCEAN_QUERY_MESSAGE_STATUS_V2`
>
> Query an outbound SMS message's delivery status by message ID. The request requires an API key and secret; non-JSON responses, including XML, are returned as error payloads.
>
> #### Input Parameters
>
> **mocean-msgid** `string` *required*
>
> Message ID returned when the SMS was submitted
>
> **mocean-api-key** `string` *required*
>
> Your Mocean API key.
>
> **mocean-api-secret** `string` *required*
>
> Your Mocean API secret.
>
> **mocean-resp-format** `string ("JSON" | "XML")`
>
> Response format. Supported: JSON, XML. Defaults to JSON.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Voice Dial V2
>
> **Slug:** `MOCEAN_VOICE_DIAL_V2`
>
> Tool to initiate an outbound voice call via Mocean API. Use when you need to place a call with a defined command flow.
>
> #### Input Parameters
>
> **mocean-to** `string` *required*
>
> Recipient phone number(s) in international format without '+'; separate multiple numbers with space or comma.
>
> **mocean-from** `string`
>
> Caller ID (originating number).
>
> **mocean-command** `string` *required*
>
> JSON-encoded array defining the call flow (e.g., play, say, collect, dial).
>
> **mocean-event-url** `string`
>
> Webhook URL to receive call status events.
>
> **mocean-resp-format** `string`
>
> Response format. Only JSON is supported.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Voice Download Recording V2
>
> **Slug:** `MOCEAN_VOICE_DOWNLOAD_RECORDING_V2`
>
> Download a call recording by call UUID. The returned file can contain an API error response rather than recording audio.
>
> #### Input Parameters
>
> **mocean-call-uuid** `string` *required*
>
> Call UUID of the recording to download.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Voice Hangup V2
>
> **Slug:** `MOCEAN_VOICE_HANGUP_V2`
>
> Request hangup of an active voice call by call UUID. The request requires an API key and secret.
>
> #### Input Parameters
>
> **mocean-api-key** `string` *required*
>
> Your Mocean API key.
>
> **mocean-call-uuid** `string` *required*
>
> The call UUID of the active call to hang up.
>
> **mocean-api-secret** `string` *required*
>
> Your Mocean API secret.
>
> **mocean-resp-format** `string ("xml" | "json")`
>
> Response format; xml or json (default json).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] WhatsApp Incoming Webhook V2
>
> **Slug:** `MOCEAN_WHATSAPP_INCOMING_WEBHOOK_V2`
>
> Validate and return a supplied incoming WhatsApp message webhook payload using the supported message schema. The returned payload contains only modeled fields.
>
> #### Input Parameters
>
> **event\_data** `object` *required*
>
> Complete detail payload of the incoming WhatsApp message
>
> **event\_type** `string` *required*
>
> Type of the event, must be 'message'
>
> **message\_id** `string` *required*
>
> Identifier for the incoming message
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] WhatsApp Send Message V2
>
> **Slug:** `MOCEAN_WHATS_APP_SEND_MESSAGE_V2`
>
> Send a WhatsApp message via Mocean, including text, media, template, reaction, or interactive content. Only templates can be sent to customers who have never messaged you or have not messaged you in the last 24 hours.
>
> #### Input Parameters
>
> **mocean-to** `string` *required*
>
> Destination WhatsApp number, with country code.
>
> **mocean-from** `string` *required*
>
> Registered WhatsApp Business sender number, with country code (e.g., 60123456789).
>
> **mocean-content** `object` *required*
>
> Content object of the message (e.g., text, media, template, reaction, interactive).
>
> **mocean-event-url** `string`
>
> Optional webhook URL for delivery events.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
