Skip to content

Contacts

Endpoints for creating, updating, and retrieving subscriber data in KlickTipp. These operations allow external systems to manage contact records, including core profile information and custom data fields.

Operations

Get Multiple Contacts

Request

Returns the complete data of up to 200 contacts.

Path
subscriberidsstring^[1-9][0-9]*(,[1-9][0-9]*){0,199}$required

Comma-separated list of numeric contact IDs.

Example:123,456
curl -i -X GET \
  'https://api.klicktipp.com/subscriber/bulk/123,456'

Responses

Success Response.

Bodyapplication/json
property name*(SubscriberDetailSchema (object or null))additional property
One of:

Legacy subscriber detail representation. Field formats and semantics are not fully normalized.

Response
{
  "property1": {
    "id": "987654321",
    "email": "alex.example@klicktipp.example",
    "status": "Subscribed",
    "bounce": "Not Bounced",
    "listid": "12345",
    "optin": "01.01.2025 12:00:00",
    "optin_ip": "0.0.0.0",
    "date": "01.01.2025 13:00:00",
    "ip": "0.0.0.0",
    "unsubscription": "",
    "unsubscription_ip": "",
    "referrer": "https://integration.example.com/webhooks/payment/ipn",
    "sms_phone": "00491701234567",
    "sms_status": "Subscribed",
    "sms_bounce": "Not Bounced",
    "sms_date": "01.02.2025 12:00:00",
    "sms_unsubscription": "",
    "sms_referrer": "https://signup.example.com/sms-form",
    "fieldFirstName": "Alex",
    "fieldLastName": "Example",
    "fieldCompanyName": "Example Corp",
    "fieldStreet1": "Example Street 1",
    "fieldStreet2": "",
    "fieldCity": "Berlin",
    "fieldState": "Berlin",
    "fieldZip": "10115",
    "fieldCountry": "DE",
    "fieldPrivatePhone": "00491701234567",
    "fieldMobilePhone": "00491707654321",
    "fieldPhone": "00492207654321",
    "fieldFax": "00492201234567",
    "fieldWebsite": "https://www.klicktipp.example",
    "fieldBirthday": "755222400",
    "fieldLeadValue": "100",
    "tags": [ … ],
    "smart_tags": { … },
    "manual_tags": { … },
    "notification_emails_sent": { … },
    "notification_emails_opened": { … },
    "notification_emails_clicked": { … },
    "emails_sent": { … },
    "emails_opened": { … },
    "emails_clicked": { … },
    "campaigns_started": { … },
    "campaigns_finished": { … }
  },
  "property2": {
    "id": "987654321",
    "email": "alex.example@klicktipp.example",
    "status": "Subscribed",
    "bounce": "Not Bounced",
    "listid": "12345",
    "optin": "01.01.2025 12:00:00",
    "optin_ip": "0.0.0.0",
    "date": "01.01.2025 13:00:00",
    "ip": "0.0.0.0",
    "unsubscription": "",
    "unsubscription_ip": "",
    "referrer": "https://integration.example.com/webhooks/payment/ipn",
    "sms_phone": "00491701234567",
    "sms_status": "Subscribed",
    "sms_bounce": "Not Bounced",
    "sms_date": "01.02.2025 12:00:00",
    "sms_unsubscription": "",
    "sms_referrer": "https://signup.example.com/sms-form",
    "fieldFirstName": "Alex",
    "fieldLastName": "Example",
    "fieldCompanyName": "Example Corp",
    "fieldStreet1": "Example Street 1",
    "fieldStreet2": "",
    "fieldCity": "Berlin",
    "fieldState": "Berlin",
    "fieldZip": "10115",
    "fieldCountry": "DE",
    "fieldPrivatePhone": "00491701234567",
    "fieldMobilePhone": "00491707654321",
    "fieldPhone": "00492207654321",
    "fieldFax": "00492201234567",
    "fieldWebsite": "https://www.klicktipp.example",
    "fieldBirthday": "755222400",
    "fieldLeadValue": "100",
    "tags": [ … ],
    "smart_tags": { … },
    "manual_tags": { … },
    "notification_emails_sent": { … },
    "notification_emails_opened": { … },
    "notification_emails_clicked": { … },
    "emails_sent": { … },
    "emails_opened": { … },
    "emails_clicked": { … },
    "campaigns_started": { … },
    "campaigns_finished": { … }
  }
}