Wunderkind Createcontactactivities API

openapi: 3.2.0
info:
  title: Wunderkind Createcontactactivities API
  version: '2026-10-03'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-03: 11 operation(s) read from 19 public documentation page(s) (each operation names its page in x-source). This is not the provider''s published contract; Wunderkind has published no machine-readable contract that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 9
    documentation: 2
    pages-with-code: 16
    pages-read: 19
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-03'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://developer.wunderkind.co/reference
  - https://developer.wunderkind.co/reference/text-message-api
  - https://developer.wunderkind.co/reference/batch-id-lookup.md
  - https://developer.wunderkind.co/reference/secret-endpoint.md
  - https://developer.wunderkind.co/reference/text-message-api.md
  - https://developer.wunderkind.co/reference/bulk-text-message-api.md
  - https://developer.wunderkind.co/reference/text-message-optin-api.md
  - https://developer.wunderkind.co/reference/text-message-status-api.md
  - https://developer.wunderkind.co/reference/text-unsubscribe-users-api.md
  - https://developer.wunderkind.co/reference/text-subscription-status-api.md
  - https://developer.wunderkind.co/docs/cordial-integration-overview
  - https://developer.wunderkind.co/docs/cordial-integration-overview.md
  - https://developer.wunderkind.co/docs/signals-for-sfmc-journey-builder
  - https://developer.wunderkind.co/docs/signals-for-sfmc-journey-builder.md
  - https://developer.wunderkind.co/reference/bulk-text-message-api
  - https://developer.wunderkind.co/reference/text-message-status-api
  - https://developer.wunderkind.co/reference/text-subscription-status-api
  - https://developer.wunderkind.co/reference/text-unsubscribe-users-api
  - https://developer.wunderkind.co/reference/text-message-optin-api
servers:
- url: https://api.wknd.ai
security:
- apiKey: []
tags:
- name: Createcontactactivities
paths:
  /createContactactivities:
    post:
      operationId: post_createContactactivities
      tags:
      - Createcontactactivities
      summary: Wunderkind triggers a Podium Orchestration by writing a Custom Event to a…
      x-source: https://developer.wunderkind.co/docs/cordial-integration-overview
      parameters:
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
        description: API key for authentication (Cordial API key connected in your Wunderkind Platform account).
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCreatecontactactivitiesRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostCreatecontactactivitiesRequest:
      type: object
      properties:
        source:
          type: string
          description: Identifier of the source system, e.g., "wk-esp".
        contact:
          type: object
          description: Contact identification and attribute block.
        contact.identifiers:
          type: object
          description: Map of identifier types to values.
        contact.identifiers.email:
          type: string
          description: Email address of the contact.
        contact.identifiersPriority:
          type: array
          description: Ordered list of identifier keys, e.g., ["email"].
        contact.attributes:
          type: object
          description: Contact attribute map.
        contact.attributes.channels.email.address:
          type: string
          description: Email address channel value.
        contact.attributes.wk_identified:
          type: boolean
          description: Flag set to true when the contact is newly created.
        contact.canBeCreated:
          type: boolean
          description: Whether Cordial may create the contact if it does not exist.
        contact.canBeUpdated:
          type: boolean
          description: Whether Cordial may update an existing contact (always false for this integration).
        contact.forceSubscribe:
          type: boolean
          description: If true, newly identified contacts are marked as already subscribed on the email channel.
        contactActivities:
          type: array
          description: Array of activity objects to fire custom events.
        contactActivities[].name:
          type: string
          description: Custom event name (e.g., wknd-email-prodabandonment).
        contactActivities[].time:
          type: string
          description: ISO‑8601 timestamp for the event.
        contactActivities[].properties:
          type: object
          description: Payload of event‑specific properties (varies by campaign strategy).
      required:
      - source
      - contact
      - contact.identifiers
      - contact.identifiers.email
      - contact.identifiersPriority
      - contact.attributes
      - contact.attributes.channels.email.address
      - contact.canBeCreated
      - contact.canBeUpdated
      - contactActivities
      - contactActivities[].name
      - contactActivities[].time
      - contactActivities[].properties
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: Authorization