Famulor SMS API

SMS-Versand.

GitHub OpenAPI

Operations 1

POST /user/sms Send SMS #

Specifications

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/famulor-io:famulor-io-sms-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

famulor-io-sms-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Famulor SMS API
  summary: REST API für AI-Assistenten, Anrufe, Konversationen, Leads und omnichannel Kundenkommunikation.
  description: 'Die Famulor Produkt-API unter `https://app.famulor.de/api`. Damit steuerst du

    AI-Assistenten, startest und liest Anrufe, verwaltest Leads und Kampagnen,

    versendest SMS und WhatsApp-Nachrichten, pflegst Wissensdatenbanken und

    automatisierst Prozesse.


    ## Authentifizierung


    Alle Endpunkte erwarten einen API-Key als Bearer-Token:


    ```

    Authorization: Bearer YOUR_API_KEY

    ```


    Den Key erstellst du in deinem Account unter im

    Bereich API-Keys. Der Key wird nur einmal angezeigt.


    ## Webhooks


    Famulor sendet Ereignisse (Post-Call, Conversation Ended, Read Receipts) an

    deine URL. Die Payloads stehen im Abschnitt `webhooks` dieser Spec.


    Diese Datei wird aus der offiziellen Dokumentation generiert:'
  version: 1.0.0
  contact:
    name: Famulor Support
    email: sales@famulor.io
    url: https://www.famulor.io/support
  license:
    name: Proprietary
    url: https://www.famulor.io/terms
  termsOfService: https://www.famulor.io/terms
servers:
- url: https://app.famulor.de/api
  description: Production
security:
- BearerAuth: []
tags:
- name: SMS
  description: SMS-Versand.
paths:
  /user/sms:
    post:
      tags:
      - SMS
      summary: Send SMS
      operationId: sendSMS
      description: 'Send an SMS message using your Famulor phone number via API. Trigger transactional or follow-up texts after AI voice calls, lead capture or campaigns.


        Docs'
      externalDocs:
        description: Send SMS
        url: https://docs.famulor.io/api-v1/sms/send
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                from:
                  type: integer
                  description: The ID of your phone number from which the SMS will be sent (must be SMS-capable)
                to:
                  type: string
                  description: The recipient's phone number in international format (e.g., "+4915123456789")
                body:
                  type: string
                  description: The SMS message content (max. 300 characters)
              required:
              - from
              - to
              - body
      responses:
        '200':
          description: Sent Successfully
          content:
            application/json:
              example:
                message: SMS sent successfully
                data:
                  sms_id: SMS_67890
                  from: '+4912345678'
                  to: '+4915123456789'
                  body: Hello! This is a test SMS from Famulor.
                  segments: 1
                  cost: 0.05
                  currency: EUR
                  status: sent
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Success message confirming that the SMS was sent
                  data:
                    type: object
                    description: Additional data about the sent SMS
                    additionalProperties: true
                  400 Bad Request:
                    type: object
                    properties:
                      message:
                        type: string
                        description: Error message describing the issue (invalid phone number, insufficient balance, etc.)
                    additionalProperties: true
                  500 Internal Server Error:
                    type: object
                    properties:
                      message:
                        type: string
                        description: Error message indicating a failure in sending the SMS
                      error:
                        type: string
                        description: Detailed error information
                    additionalProperties: true
                additionalProperties: true
        '400':
          description: Bad Request
          content:
            application/json:
              examples:
                invalid-request:
                  summary: Invalid Request
                  value:
                    message: Invalid phone number format
                insufficient-balance:
                  summary: Insufficient Balance
                  value:
                    message: Insufficient balance to send SMS
                phone-number-not-sms-capable:
                  summary: Phone Number Not SMS-Capable
                  value:
                    message: Phone number is not SMS-capable
                phone-number-not-found:
                  summary: Phone Number Not Found
                  value:
                    message: From number not found
        '401':
          $ref: '#/components/responses/Unauthorized'
        '422':
          $ref: '#/components/responses/ValidationError'
        '500':
          description: Server Error
          content:
            application/json:
              example:
                message: Failed to send SMS
                error: Twilio service temporarily unavailable
components:
  responses:
    ValidationError:
      description: Die Anfrage ist inhaltlich ungültig.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ValidationError'
          example:
            message: The given data was invalid.
            errors:
              phone_number:
              - The phone number field is required.
    Unauthorized:
      description: Fehlender oder ungültiger API-Key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            message: Unauthenticated.
  schemas:
    ValidationError:
      type: object
      properties:
        message:
          type: string
        errors:
          type: object
          description: Feldname → Liste der Fehlermeldungen.
          additionalProperties:
            type: array
            items:
              type: string
    Error:
      type: object
      properties:
        message:
          type: string
          description: Menschenlesbare Fehlermeldung.
        error:
          type: string
          description: Fehlerkennung, sofern gesetzt.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 'API-Key als Bearer-Token: `Authorization: Bearer YOUR_API_KEY`. Key erstellen unter https://app.famulor.de.'
externalDocs:
  description: Famulor API-Dokumentation
  url: https://docs.famulor.io/api-v1/introduction