canonical: https://jentic.com/apis/mensagia.com/mensagia # Mensagia API The Mensagia API is a multi-channel messaging platform covering SMS, email, voice campaigns, two-factor authentication, certified messaging, and contact management across 83 endpoints. Senders can dispatch single or bulk SMS and email, organise contacts into groups, build scheduled campaigns, and receive delivery notifications, all under either bearer-token or API-token authentication. The platform is well suited to teams that want a single integration for transactional notifications, marketing campaigns, and OTP verification without standing up separate vendors per channel. ## For AI agents Send SMS, email, and voice messages, manage contact lists, run campaigns, and issue 2FA codes through one multi-channel platform. Bearer or API-token authentication. ## Scope Does not handle in-app push notifications, video conferencing, or social DMs - use for SMS, email, voice, and 2FA dispatch with contact and campaign management only. ## Capabilities - Send single and bulk SMS messages with delivery tracking via the platform's send endpoints - Dispatch transactional and marketing email through the same authenticated client - Build and schedule multi-recipient campaigns across SMS, email, and voice channels - Manage contacts and groups including imports and segment-based targeting - Issue and verify 2FA codes for application sign-in flows - Monitor account balance and request top-ups through /balance endpoints ## Use cases ### Transactional SMS Notifications E-commerce and logistics platforms use Mensagia to dispatch order confirmations, shipping updates, and delivery alerts over SMS. The API accepts a single recipient or a batch and returns per-message status, which lets the application reconcile delivery reports against orders and trigger fallbacks when a number is undeliverable. Example prompt: Call the SMS send endpoint with the customer's phone number and the order-confirmation template, store the returned message ID against the order, then poll for delivery status. ### Marketing Campaign Dispatch Marketing teams build segmented contact groups in Mensagia, then schedule SMS or email campaigns through the platform's campaigns and contacts endpoints. The unified API lets the same workflow target SMS, email, or voice without changing client logic, which simplifies multi-channel reactivation and promotion campaigns. Example prompt: Create a contact group of customers tagged 'lapsed', schedule an SMS campaign for tomorrow at 10:00 with a promo code, and confirm the scheduled time in the response. ### Two-Factor Authentication Application sign-in flows use Mensagia's 2FA endpoints to send one-time codes by SMS, then verify the code returned by the user. The platform handles code generation, expiry, and verification, which removes the need to build and store OTP state inside the application database. Example prompt: Trigger a 2FA send to the user's phone, then on the user's submission call the verify endpoint with the code and return success or failure to the sign-in flow. ### AI Agent Notification Tooling An AI assistant orchestrating long-running tasks can notify users by SMS or email through Mensagia. Through Jentic, the agent loads the send-SMS and send-email operations as discoverable tools and dispatches notifications without writing channel-specific HTTP clients, while the platform's balance endpoint lets the agent surface low-credit warnings to the operator. Example prompt: Search Jentic for 'send an sms', execute the SMS send operation with the user's phone number and message text, then call /balance to log the remaining credit. ## Key endpoints | Method | Path | Description | | --- | --- | --- | | POST | `/login` | Authenticate and obtain a bearer token | | GET | `/balance` | Get current account balance | | POST | `/balance/requests` | Create a balance top-up request | | GET | `/contacts` | List contacts | | POST | `/contacts` | Create a contact | | PUT | `/contacts/{id}` | Update a contact | ## Key resources - **SMS** — Endpoints to send single and bulk SMS messages with delivery tracking. - **Email** — Transactional and marketing email dispatch through the same authenticated session. - **Voice** — Voice campaign endpoints for outbound calling and IVR-style flows. - **Contacts and Groups** — Contact CRUD and group membership for segmented campaigns. - **Campaigns** — Schedule and manage multi-recipient marketing dispatches across channels. - **2FA** — Send and verify one-time codes for sign-in and transaction confirmation. - **Balance** — Account balance, top-up requests, and approval workflows. ## Why Jentic - **Setup:** Wiring Mensagia by hand means choosing between its bearer token from /login and its query-string api_token per endpoint and hand-coding each SMS, email, voice, and contact call against api.mensagia.com. Through Jentic you install once, import the Mensagia API from the API Directory, store the credential once, and your agent calls it. - **Permission scoping:** Mensagia's dispatch operations carry their target in the request body, so scope the agent to the operations it needs, such as sending an SMS or verifying a 2FA code. You choose the operations it may call, so contact deletion or a balance request is included only if you add it. - **Credential handling:** Your Mensagia bearer token or api_token is stored once, encrypted, by your own Jentic One instance, which injects the one each endpoint expects at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'send an SMS', 'send a transactional email', or 'verify a 2FA code', and Jentic returns the matching operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Twilio** — Larger global SMS, voice, and email provider with deeper carrier coverage - **MessageBird** — European multi-channel messaging platform - **SendGrid** — Email-only specialist with stronger deliverability tooling ## FAQ ### What authentication does the Mensagia API use? The API supports two schemes: HTTP bearer authentication via /login and an `api_token` query parameter for simpler scripts. Through Jentic, either credential is held in the encrypted vault and injected at request time so it never enters agent context. ### Can I send SMS and email from the same Mensagia API integration? Yes. Mensagia exposes SMS, email, and voice endpoints under one authenticated session, so the same client can dispatch a transactional SMS and a marketing email without switching credentials or base URLs. ### What are the rate limits for the Mensagia API? The OpenAPI spec does not declare numeric per-second rate limits - throughput is gated by your account balance and channel-specific tier. Use the /balance endpoint to monitor remaining credit before high-volume campaigns. ### How do I send an SMS through Jentic? Run `pip install jentic`, search for `send an sms`, load the SMS send operation, and execute with the recipient phone number and message text. Jentic handles bearer-token injection and returns the message ID for delivery tracking. ### Does the Mensagia API support 2FA verification flows? Yes. Mensagia exposes endpoints to send a one-time code by SMS and verify the code the user submits, which lets sign-in and high-value-transaction flows enforce two-factor authentication without storing OTP state locally. ### Is the Mensagia API free? No. Mensagia operates on prepaid balance - each SMS, email, voice call, and 2FA dispatch consumes credit from your account. Use /balance and `/balance/requests` to monitor and top up before scaling campaigns. ### Can I limit what my agent is allowed to do with the Mensagia API? Yes. Because you run Jentic One yourself, you decide which Mensagia operations your agent can call and the credential it uses, so it can be limited to just sending an SMS or verifying a 2FA code. Since Mensagia's dispatch operations carry their target in the request body, higher-impact operations like deleting a contact or filing a balance top-up request are included only if you add them. The agent can call nothing you have not granted.