Skip to main content
POST
/
api
/
v1
/
admin
/
{mobilityProviderCountryCode}
/
{mobilityProviderCode}
/
users
Create user
curl --request POST \
  --url https://api.smartmove.eu/m2m/api/v1/admin/{mobilityProviderCountryCode}/{mobilityProviderCode}/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "productKey": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "dateOfBirth": "2025-10-17T00:00:00.000Z",
  "language": "de",
  "phone": "<string>",
  "email": "<string>",
  "contactAddress": {
    "address": "<string>",
    "city": "<string>",
    "zipCode": "<string>",
    "countryCode": "DE",
    "federalState": "<string>"
  },
  "billingAddress": {
    "address": "<string>",
    "city": "<string>",
    "zipCode": "<string>",
    "countryCode": "DE",
    "federalState": "<string>",
    "company": "<string>",
    "vatNumber": "<string>"
  },
  "customerType": "Private"
}
'
{
  "id": "<string>",
  "language": "de",
  "emailVerified": true,
  "customerType": "Private",
  "firstName": "<string>",
  "lastName": "<string>",
  "dateOfBirth": "2025-10-17T00:00:00.000Z",
  "phone": "<string>",
  "email": "<string>",
  "productKey": "<string>",
  "productSubscriptionStart": "<string>",
  "productSubscriptionEnd": "<string>",
  "status": "New",
  "contactAddress": {
    "address": "<string>",
    "city": "<string>",
    "zipCode": "<string>",
    "federalState": "<string>",
    "countryCode": "DE"
  },
  "billingAddress": {
    "address": "<string>",
    "city": "<string>",
    "zipCode": "<string>",
    "federalState": "<string>",
    "countryCode": "DE",
    "company": "<string>",
    "vatNumber": "<string>"
  },
  "driversLicense": {
    "licenseType": "<string>",
    "issuingAuthority": "<string>",
    "licenseNumber": "<string>",
    "issueDate": "2025-10-17T00:00:00.000Z",
    "blobs": [
      {
        "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "contentType": "image/jpeg",
        "filename": "<string>"
      }
    ]
  },
  "identificationDocument": {
    "documentType": "<string>",
    "issuingAuthority": "<string>",
    "documentNumber": "<string>",
    "issueDate": "2025-10-17T00:00:00.000Z",
    "blobs": [
      {
        "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "contentType": "image/jpeg",
        "filename": "<string>"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
mobilityProviderCountryCode
string
required

The two-letter country code of the mobility provider the user should be created under

Required string length: 2
​
mobilityProviderCode
string
required

The three-character code of the mobility provider the user should be created under

Required string length: 3

Body

application/json

The request body contains the information about the user that should be created

​
productKey
string
required

Key/Id of chosen mobility product

​
firstName
string
required

Customer's first name

​
lastName
string
required

Customer's last name

​
dateOfBirth
string<date>
required

Customer's date of birth

Example:

"2025-10-17T00:00:00.000Z"

​
language
enum<string>
required
Available options:
de,
en
​
phone
string
required

Customer phone number

​
email
string
required

Customer email address

​
contactAddress
object
required
​
billingAddress
object
required
​
customerType
enum<string>
required
Available options:
Private,
Company

Response

The created user

​
id
string
required

Customer id

​
language
enum<string>
required
Available options:
de,
en
​
emailVerified
boolean
required

Is customer email verified

​
customerType
enum<string>
required
Available options:
Private,
Company
​
firstName
string

Customer first name

​
lastName
string

Customer last name

​
dateOfBirth
string<date>

Customer date of birth

Example:

"2025-10-17T00:00:00.000Z"

​
phone
string

Customer phone number

​
email
string

Customer email address

​
productKey
string

Key/Id of chosen mobility product

​
productSubscriptionStart
string

Subscription start date of chosen mobility product

​
productSubscriptionEnd
string

Subscription end date of chosen mobility product

​
status
enum<string>
Available options:
New,
Incomplete,
Pending,
Active,
Blocked,
Inactive
​
contactAddress
object
​
billingAddress
object
​
driversLicense
object
​
identificationDocument
object