Register a new customer (end-user)

POST

https://api.studiointern.de/{customer_shortname}/v2/pub/customer/register

Last modified:2026-07-24 11:38:00

Maintainer:Not configured

Intended for online contact / registration forms.

ist_schueler=1: customer is also the student (student arrays still required by validator).

ist_schueler=2: separate students via sch_vorname[], sch_nachname[], sch_geb[].

Never deletes or overwrites existing customer master data. Prefer this over deprecated v1 /pub/user.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Path Params

Body Params

application/json

Required

Examples

Responses

🟢200

application/json

Customer already exists

Bodyapplication/json

🟢201

🟠400

🟠401

🟠403

🟠404

🟠429

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.studiointern.de//v2/pub/customer/register' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "anrede": "string",
    "titel": "string",
    "vorname": "string",
    "nachname": "string",
    "adresse": "string",
    "adresszusatz": "string",
    "geburtstag": "2019-08-24",
    "plz": "string",
    "ort": "string",
    "telefon": "string",
    "mobil": "string",
    "email": "user@example.com",
    "bemerkungen": "string",
    "ist_schueler": 1,
    "notify": 0,
    "notify_error": "user@example.com",
    "studio_mail_address": "user@example.com",
    "no_custos": 0,
    "no_email_check": 0,
    "sch_vorname": [
        "string"
    ],
    "sch_nachname": [
        "string"
    ],
    "sch_geb": [
        "2019-08-24"
    ]
}'

Response Example

200 - Example 1

{
    "success": true,
    "code": 0,
    "locale": "de",
    "message": "string",
    "data": {
        "cID": 0,
        "students": [
            0
        ]
    },
    "links": {},
    "meta": {}
}

Modified at 2026-07-24 11:38:00

Customer registration flow info

Submit contract revocation request (Widerruf)