Skip to content
/
Update Contact

Update Contact

Request

Updates a contact.

Path
subscriberidstringrequired

The identifier of the contact. This can be either:

  • Internal Subscriber ID (Contact ID)
    Recommended for internal, server-side integrations.
    Numeric string, for example 987654321.

  • External Subscriber Key (Contact Key)
    Recommended for external communication such as email links, redirect URLs and form integrations.
    Alphanumeric string, for example 01234abcdefghij56789.

Both identifiers can be used interchangeably in this endpoint.

Example:987654321
Body
required
newemailstring or 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"
newsmsnumberstring or 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"
fieldsobject or 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: <strong>Hello World</strong>
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": "+492201234567",
  "fieldWebsite": "https://www.klicktipp.example",
  "fieldBirthday": "755222400",
  "fieldLeadValue": "100",
  "field12345": "Custom Field Value"
}
curl -i -X PUT \
  https://api.klicktipp.com/subscriber/987654321 \
  -H 'Content-Type: application/json' \
  -d '{
    "newemail": "alex.example@klicktipp.example",
    "newsmsnumber": "+491701234567",
    "fields": {
      "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": "+492201234567",
      "fieldWebsite": "https://www.klicktipp.example",
      "fieldBirthday": "755222400",
      "fieldLeadValue": "100",
      "field12345": "Custom Field Value"
    }
  }'

Responses

Success Response (200).

Bodyapplication/json
Array of booleans
Response
[
  true
]