---
title: "Initiates OptIn"
method: POST
path: "/v1/publicapplets/{hashId}/optin/initiate_subscribe"
tags: ["publicapplets"]
---

# Initiates OptIn

`POST /v1/publicapplets/{hashId}/optin/initiate_subscribe`

## Request

- Base URL: `https://apiv1.linkmobility.eu/api`
- URL: `https://apiv1.linkmobility.eu/api/v1/publicapplets/{hashId}/optin/initiate_subscribe`
- Auth: none declared

## Path parameters

- `hashId` string, required

## Request body

- InitiateOptInRequestDto
  - `contactGroupIds` integer[]: contact group ids
  - `contact` InitiateOptInContactRequest
    - `title` string: title
    - `firstName` string: first name
    - `lastName` string: last name
    - `nickname` string: nickname
    - `mobile` string, required: mobile phone number
    - `landline` string: landline phone number
    - `fax` string: fax number
    - `emailAddress` string: email address
    - `birthday` string, date-time: birthday
    - `homepage` string: homepage
    - `instantMessenger` string: instant messenger user
    - `skype` string: skype name
    - `remarks` string: custom remarks
    - `street` string: street
    - `zipCode` string: zip code
    - `city` string: city
    - `country` string: country
    - `company` string: company name
    - `department` string: department
    - `bureau` string: bureau
    - `jobTitle` string: job title
    - `whatsapp` string: whatsapp recipient
  - `optinChannels` string[]: channels
  - `termsAndConditions` string: terms and conditions
  - `acceptTermsAndConditions` boolean: accept terms and conditions?

## Response `200`

OK

## Other responses

- `400`: Bad request
- `500`: Internal server error

## Changes

- **2026-09-09** `d99d0251a3f5`: 1 info
  - api operation id `initiateOptIn_1` removed and replaced with `initiateOptIn`

[Operation history](https://skmtc.dev/linkmobility/apis/untitled-api/changes/v1/publicapplets/:hashId/optin/initiate_subscribe/post.md)

---

[API](https://skmtc.dev/linkmobility/apis/untitled-api.md) - [All operations](https://skmtc.dev/linkmobility/apis/untitled-api/llms.txt) - [OpenAPI document](https://skmtc.dev/linkmobility/apis/untitled-api/revisions/029548691274?raw)