smsmode (BYOK) — connector documentation
- MCP endpoint:
https://byok-smsmode.connectorbay.com/mcp - REST API:
POST https://byok-smsmode.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec athttps://byok-smsmode.connectorbay.com/openapi.json - Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
- Authentication: your own smsmode smsmode API key, sent in the
X-Upstream-Keyheader of every request (never stored, logged or cached) - Health:
https://byok-smsmode.connectorbay.com/health· Tool schemas:https://byok-smsmode.connectorbay.com/tools.json - Publisher: Unify Dynamics LLC · connectorbay.com/byok-smsmode · agent@connectorbay.com
What smsmode (BYOK) is for
smsmode (BYOK) lets an AI assistant read your own smsmode data through the smsmode API with a key you supply (smsmode API key). Read-only: 8 tools (list_organisations, get_organisation, list_channels, get_channel, list_consumptions, list_credit_transfers, list_campaigns, get_campaign). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to rest.smsmode.com. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by smsmode. smsmode and its logos are trademarks of their owners and are used only to say which service the connector works with.
Ask your assistant things like:
- "What is the balance and monthly SMS spend of my smsmode organisations?"
- "What is the balance of smsmode organisation 0cb2db9b?"
- "Which smsmode channels do I have and how close are they to their daily limits?"
- "What are the limits of smsmode channel 67c15045?"
- "How many messages and how much did my smsmode channel use each month?"
- "What credit did I move between smsmode sub-accounts?"
What it does
list_organisations: List the organisations (account and sub-accounts) with state, balance, payment type and monthly consumption against its limit. Contact and billing details are not returned.get_organisation: Get one organisation: state, balance, payment type and monthly consumption against its limit. Contact and billing details are not returned.list_channels: List an organisation's SMS and RCS channels with flow (marketing, transactional, OTP), sender ids, daily and monthly consumption and limits.get_channel: Get one channel's flow, sender ids, daily and monthly consumption and limits, and archive period.list_consumptions: List a channel's monthly or daily message consumption: quantity and price per period.list_credit_transfers: List credit transfers between an organisation and its sub-organisations: direction, source and destination names, amount, currency and reference.list_campaigns: List SMS campaigns of a channel with send and end dates, sender, message count, price and status (scheduled, ongoing, ended). Message text and recipients are not returned.get_campaign: Get one SMS campaign: dates, sender, message count, price and status. Message text and recipients are not returned.
BYOK key
You bring your own smsmode smsmode API key (https://dev.smsmode.com/commons/v1/#tag/Credential). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to rest.smsmode.com over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.
Data sources
- https://dev.smsmode.com/sms/v1/ (the API this connector calls, with a BYOK key)
Live from the smsmode API (rest.smsmode.com) with a BYOK key; documentation: https://dev.smsmode.com/sms/v1/. Endpoints checked against that documentation on 2026-10-16.
What it is not
Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by smsmode. smsmode and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your smsmode account.
Built for: Worldwide. Languages: English.