Add Mobile Access Key

post

Creates a new mobile access key and either assigns it to a new or existing user.

Authorizations

Bearer

AuthorizationstringRequired

Enter the Bearer Authorization string as following: Bearer Generated-JWT-Token

Body

application/json

Contains details for creating a new mobile access key.

userIdstring · uuid · nullableOptional

UUID of the existing user to assign the access key to. To create a new user, userId must be omitted.

userFirstNamestring · nullableOptional

(optional) First name of the user.

userLastNamestring · nullableOptional

(optional) Last name of the user.

keyNamestring · nullableOptional

(optional) A name of the access key. The name will be included in any notifications sent to the user to refer to this particular access key.

accessesstring · uuid[]Required

A list of accesses, specified by id, that should be authorized to the access key.

validFromstring · nullableOptional

(optional) ISO 8601 formatted date from where the access key becomes active. If omitted, the access key will be active immediately after creation.

validTostring · nullableOptional

(optional) ISO 8601 formatted date from where the access key expires. If omitted, the access key will never expire.

mobilePhoneNumberstring · nullableOptional

A E.164 formatted mobile phone number that should be associated to the user. The mobile phone number will be associated to the user as a secondary identity.

Responses

202

Success

application/json

400

Bad Request

application/json

403

Forbidden

application/json

409

Conflict

application/json

post

/integrator/v1/accesskeys/mobile

HTTPcURLJavaScriptPython

POST /integrator/v1/accesskeys/mobile HTTP/1.1
Host: api.kiiaccess.se
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 272

{
  "userId": "123e4567-e89b-12d3-a456-426614174000",
  "userFirstName": "text",
  "userLastName": "text",
  "keyName": "text",
  "accesses": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "validFrom": "text",
  "validTo": "text",
  "mobilePhoneNumber": "text",
  "metaData": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "userId": "text",
  "userFirstName": "text",
  "userLastName": "text",
  "keyType": "text",
  "keyFormat": "text",
  "keyIdentification": "text",
  "keyName": "text",
  "accesses": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "validFrom": "2026-03-14T21:38:46.049Z",
  "validTo": "2026-03-14T21:38:46.049Z",
  "metaData": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}