# Signin

Creates or updates a contact and associates the tag linked to the API key.

Notice: On success, the endpoint returns a system-generated redirect URL depending on the opt-in configuration in KlickTipp.

For Double Opt-in, the URL points to a pending page indicating that email confirmation is required.

For Single Opt-in, the URL points to a final thank-you page.

The client may use this URL for optional redirection; the API itself does not perform any redirect.

Endpoint: POST /subscriber/signin
Version: 1.0.0

## Request fields (application/json):

  - `apikey` (string, required)
    API key
    Example: "{{api_key}}"

  - `email` (string,null)
    Valid email address and must contain @.

Either email or smsnumber is required.
Email address must be unique per contact.
    Example: "alex.example@klicktipp.example"

  - `smsnumber` (string,null)
    Phone number in international format.

Either email or smsnumber is required.
SMS number must be unique per contact.

  Accepted input:
  - +4912345678
  - 004912345678

  Stored format:
- 004912345678
    Example: "+491701234567"

  - `fields` (object,null)
    Additional custom fields for the subscriber.

Keys must match the field names configured in KlickTipp.
Each field expects a specific data format depending on its field type.

- Line: Single-line text without line breaks.
  Example: Alex Example
- Paragraph: Text with paragraphs. Use \n to separate paragraphs.
  Example: Dies ist ein Text.\nMit Absatz.
- Number: Integer value. No dot, no comma.
  Example: 42
- Decimal Number: Decimal value. Output always uses a dot as decimal separator.
  Example: Input 1999 → Output 19.99
- URL: Valid web address. Must start with http:// or https://.
  Example: https://klicktipp.com
- Time: Unix timestamp between 0 and 86399 (seconds since midnight).
  Example: 52200 (14:30 GMT)
- Date: Unix timestamp in seconds. Date formats like DD.MM.YYYY are not supported.
  Example: 1715126400 (08.05.2024 GMT)
- Date & Time: Unix timestamp in seconds. Do not send formatted date strings or values with spaces.
  Example: 1715603400 (13.05.2024 12:30:00 GMT)
- HTML: HTML-formatted content. Only use this type if the field explicitly allows HTML.
  Example: Hello World
    Example: {"fieldFirstName":"Alex","fieldLastName":"Example","fieldCompanyName":"Example Corp","fieldStreet1":"Example Street 1","fieldStreet2":"","fieldCity":"Berlin","fieldState":"Berlin","fieldZip":"10115","fieldCountry":"DE","fieldPrivatePhone":"+491701234567","fieldMobilePhone":"+491701234567","fieldPhone":"+492201234567","fieldFax":"4922012345678","fieldWebsite":"https://www.klicktipp.example","fieldBirthday":"755222400","fieldLeadValue":"100","field12345":"Custom Field Value"}