canonical: https://jentic.com/apis/46elks.com/46elks

# 46elks API

Jentic publishes the only available OpenAPI specification for 46elks API, keeping it validated and agent-ready. The 46elks API lets applications send and receive SMS, MMS, and voice calls and manage virtual phone numbers from a Nordic-focused communications provider. Authentication is HTTP Basic with the account API username and password. The 13 endpoints cover SMS, MMS, calls, numbers, and account information.

## For AI agents

Send and receive SMS and MMS, place phone calls, and manage virtual phone numbers via 46elks using HTTP Basic auth.

## Scope

Does not handle email, push notifications, or chat platforms - use for SMS, MMS, voice calls, and virtual number management only.

## Capabilities

- Send outbound SMS messages to any international number using POST /sms
- Send MMS messages with image or media attachments via POST /mms
- Place outbound voice calls and control flow with the calls endpoint
- List and retrieve historical SMS messages and call records by ID
- Provision and manage virtual phone numbers across supported countries via the numbers endpoints
- Retrieve account balance and metadata via GET /me

## Use cases

### Two-Factor Authentication SMS

Send one-time codes for login or transaction verification via 46elks SMS. POST /sms accepts a sender alpha-tag, a recipient in international format, and a message body. The response carries a message ID that can be reconciled later via GET /sms/{smsId} for delivery tracking.

Example prompt: Send an SMS to +46701234567 with body 'Your code is 482917' from sender 'AcmeApp' via POST /sms and capture the returned message ID.

### Outbound Voice Call Notifications

Place automated voice calls for high-priority alerts that SMS or email might miss, such as on-call escalations or appointment reminders. POST /calls initiates the call; the body specifies the recipient and the call flow (text-to-speech or audio URL). GET /calls/{callId} returns the call's outcome.

Example prompt: Place an outbound call to +46701234567 with a text-to-speech message announcing a Sev1 incident, capture the call ID, and poll its outcome.

### MMS Picture Messaging

Send picture messages such as receipts, ID confirmations, or order updates by referencing an image URL in POST /mms. This is useful where a screenshot or visual confirmation conveys more than text and the recipient's carrier supports MMS.

Example prompt: Send an MMS to +46701234567 with the image at https://example.com/receipt.png and caption 'Your receipt for order #42' using POST /mms.

### Agent-Driven Multichannel Notifications

Let an AI agent choose between SMS, MMS, and voice call based on the message type and route through Jentic. The agent searches by intent, loads the schema, and supplies recipient and content; HTTP Basic credentials stay isolated in Jentic's vault.

Example prompt: Through Jentic, search 'send an sms', load the 46elks POST /sms schema, and send a confirmation SMS to a recipient list.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /sms | Send an SMS message |
| GET | /sms/{smsId} | Retrieve a single SMS |
| POST | /calls | Place an outbound voice call |
| POST | /mms | Send an MMS picture message |
| GET | /numbers | List virtual phone numbers |
| GET | /me | Get account balance and metadata |

## Key resources

- **SMS** — Send and list SMS messages
- **MMS** — Send picture messages
- **Calls** — Place and retrieve outbound voice calls
- **Numbers** — Provision and manage virtual phone numbers
- **Account** — Retrieve account balance and metadata via /me

## Why Jentic

- **Setup:** Wiring the 46elks API by hand means managing its HTTP Basic username and password, building the Authorization header, and shaping SMS, MMS, and voice payloads yourself. Through Jentic you install once, import the 46elks API from the API Directory, store the credentials once, and your agent calls it.
- **Permission scoping:** 46elks carries recipients in the request body rather than a resource id in the path, so limit the agent to the operations it needs, such as sending SMS or reading a message by id, and leave out placing calls or sending MMS unless you add them. You choose the allowed set, so only the operations you pick can run.
- **Credential handling:** Your 46elks Basic credentials are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'send an SMS' or 'place a phone call', and Jentic returns the matching 46elks operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Twilio Messaging** — Twilio Messaging covers SMS, MMS, and WhatsApp at global scale with extensive carrier integrations.
- **MessageBird SMS API** — MessageBird offers SMS plus voice and conversations across European and global numbers.
- **ClickSend API** — ClickSend provides global SMS, MMS, voice, and direct mail through a single API.

## FAQ

### Why is there no official OpenAPI spec for 46elks API?

46elks publishes HTML reference docs at 46elks.com/docs but no OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call 46elks API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the 46elks API use?

It uses HTTP Basic authentication with your 46elks API username and password as documented at 46elks.com/docs. Through Jentic, the credentials are stored encrypted in the vault and injected into the Authorization header at execution.

### Can I send MMS picture messages with 46elks?

Yes. POST /mms accepts a recipient and an image URL plus optional caption, and returns a message ID. MMS delivery requires the recipient's carrier and device to support MMS; otherwise the message may be returned as a text fallback.

### Can I provision virtual phone numbers through the API?

Yes. The Numbers endpoints (GET /numbers and GET /numbers/{numberId}) let you list available and currently allocated numbers. Provisioning and termination are also handled via the same Numbers resource.

### How do I send an SMS with 46elks through Jentic?

Run pip install jentic, then search 'send an sms', load the 46elks POST /sms operation, supply the from, to, and message fields, and execute. Run it through Jentic One, the self-hosted execution layer to receive an agent API key for execution.

### How do I check my 46elks account balance?

Call GET /me. The response includes the account balance and currency along with account metadata, which is useful before launching a high-volume campaign.

### Can I limit what my agent is allowed to do with the 46elks API?

Yes. Because you run Jentic One yourself, you decide which 46elks operations your agent can call, so you can allow only what it needs, such as sending an SMS with POST /sms or reading a single message with GET /sms/{smsId}, while leaving out placing voice calls with POST /calls or sending MMS with POST /mms. Since 46elks carries the recipient in the request body rather than a path id, scoping is done at the operation level, and only the operations you enable can run. Your Basic credentials stay under your control and are injected at execution rather than exposed to the agent.