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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/famulor-io:famulor-io-labels-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
openapi: 3.2.0
info:
title: Famulor Labels 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: Labels
description: Labels für Leads und Konversationen.
paths:
/user/label:
post:
tags:
- Labels
summary: Create Label
operationId: createLabel
description: 'Create a label to tag your assistants
Docs'
externalDocs:
description: Create Label
url: https://docs.famulor.io/api-v1/labels/create
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
description: The label name (max 255 characters). Must be unique within your account.
color:
type: string
description: 'A color for the label badge. One of: `gray`, `slate`, `red`, `orange`, `amber`, `green`, `teal`, `blue`, `purple`, `pink`.'
enum:
- gray
- slate
- red
- orange
- amber
- green
- teal
- blue
- purple
- pink
required:
- name
responses:
'201':
description: Success Response
content:
application/json:
example:
message: Label created successfully
data:
id: 3
name: Inbound
color: green
assistants_count: 0
schema:
type: object
properties:
message:
type: string
description: Success message
data:
type: object
properties:
id:
type: integer
description: The unique identifier of the created label
name:
type: string
description: The label name
color:
type: string
description: The label color (or `null`)
assistants_count:
type: integer
description: Number of assistants this label is applied to (always `0` for a new label)
additionalProperties: true
additionalProperties: true
'401':
$ref: '#/components/responses/Unauthorized'
'422':
description: Validation Error
content:
application/json:
example:
message: The name has already been taken.
errors:
name:
- The name has already been taken.
/user/label/{id}:
delete:
tags:
- Labels
summary: Delete Label
operationId: deleteLabel
description: 'Delete a label
Docs'
externalDocs:
description: Delete Label
url: https://docs.famulor.io/api-v1/labels/delete
parameters:
- name: id
in: path
required: true
description: The label ID. Must belong to your account.
schema:
type: integer
responses:
'200':
description: Success Response
content:
application/json:
example:
message: Label deleted successfully
'401':
$ref: '#/components/responses/Unauthorized'
'404':
description: Not Found
content:
application/json:
example:
message: Label not found
'422':
$ref: '#/components/responses/ValidationError'
put:
tags:
- Labels
summary: Update Label
operationId: updateLabel
description: 'Rename a label or change its color
Docs'
externalDocs:
description: Update Label
url: https://docs.famulor.io/api-v1/labels/update
parameters:
- name: id
in: path
required: true
description: The label ID. Must belong to your account.
schema:
type: integer
requestBody:
required: false
content:
application/json:
schema:
type: object
properties:
name:
type: string
description: New name (max 255 characters). Must be unique within your account.
color:
type: string
description: 'New color. One of: `gray`, `slate`, `red`, `orange`, `amber`, `green`, `teal`, `blue`, `purple`, `pink`. Send `null` to clear it.'
enum:
- gray
- slate
- red
- orange
- amber
- green
- teal
- blue
- purple
- pink
responses:
'200':
description: Success Response
content:
application/json:
example:
message: Label updated successfully
data:
id: 3
name: Inbound calls
color: teal
assistants_count: 7
schema:
type: object
properties:
message:
type: string
description: Success message
data:
type: object
properties:
id:
type: integer
description: The label ID
name:
type: string
description: The label name
color:
type: string
description: The label color (or `null`)
assistants_count:
type: integer
description: Number of assistants this label is applied to
additionalProperties: true
additionalProperties: true
'401':
$ref: '#/components/responses/Unauthorized'
'404':
description: Not Found
content:
application/json:
example:
message: Label not found
'422':
$ref: '#/components/responses/ValidationError'
/user/labels:
get:
tags:
- Labels
summary: List Labels
operationId: listLabels
description: 'List the labels in your account
Docs'
externalDocs:
description: List Labels
url: https://docs.famulor.io/api-v1/labels/list
parameters:
- name: per_page
in: query
required: false
description: 'Number of labels per page (1-100, default: 15)'
schema:
type: integer
- name: page
in: query
required: false
description: 'Page number (default: 1)'
schema:
type: integer
responses:
'200':
description: Success Response
content:
application/json:
example:
data:
- id: 3
name: Inbound
color: green
assistants_count: 7
- id: 5
name: Outbound
color: blue
assistants_count: 2
current_page: 1
per_page: 15
total: 2
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
id:
type: integer
description: The unique identifier of the label
name:
type: string
description: The label name
color:
type: string
description: The label color (or `null`)
assistants_count:
type: integer
description: Number of assistants this label is applied to
additionalProperties: true
additionalProperties: true
'401':
$ref: '#/components/responses/Unauthorized'
'422':
$ref: '#/components/responses/ValidationError'
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