Wunderkind

Wunderkind Wunderhook API

The Signals Wunderhook consumer contract — the single POST endpoint a client stands up to RECEIVE Wunderkind Signals webhook deliveries. The base URL is therefore templated and client-owned (https://{yourendpoint}), not a Wunderkind-operated host; Wunderkind is the sender. Deliveries are authenticated with static headers or Basic auth from a published 20-address IP allowlist, with no HMAC signing.

GitHub OpenAPI

Operations 1

POST / New Endpoint #

Documentation

📖
APIReference
https://developer.wunderkind.co/reference/sendemail
📖
Documentation
https://developer.wunderkind.co/reference/identity-api
📖
APIReference
https://developer.wunderkind.co/reference/batch-id-lookup
📖
APIReference
https://developer.wunderkind.co/reference/external_subscribe
📖
Documentation
https://developer.wunderkind.co/docs/event-ingestion-api-guide
📖
APIReference
https://developer.wunderkind.co/reference/service_visit

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/wunderkind/refs/heads/main/openapi/wunderkind-wunderhook-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/wunderkind-wunderhook-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

wunderkind-wunderhook-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 1.0.0
  title: Wunderhook API
servers:
- url: https://{yourendpoint}
tags:
- name: Wunderhook
paths:
  /:
    post:
      summary: New Endpoint
      description: This is your first endpoint! Edit this page to start documenting your API.
      operationId: get_new-endpoint
      responses:
        '200':
          description: Successful response
      requestBody:
        content:
          application/json:
            schema:
              properties:
                Recipient:
                  type: string
                  description: 'The email address or phone number of the recipient. '
                RecipientSha256:
                  type: string
                  description: The SHA256 encoded string of the recipient, lowercased before hashing. Required if Recipient is not submitted.
                WkPurpose:
                  type: string
                  default: ''
                  description: the purpose for this signal (cart abandonment, category abandonment, low stock, etc.)
                WkChannel:
                  type: string
                  description: the recommended channel (email, text, etc.)
                WkUserType:
                  type: string
                  description: the recommended target (customer, prospect, all)
                WkCartReplenishUrl:
                  type: string
                  description: the url to drive user back to their cart (if applicable)
                WkCouponCode:
                  type: string
                  description: coupon code to serve (if applicable)
                WkCouponPurpose:
                  type: string
                  description: coupon code purpose (ie - "Get 20% off") (if applicable)
                WkItems:
                  type: array
                  items:
                    properties:
                      WkId:
                        type: string
                        description: Unique product identifier id
                      WkCopy:
                        type: string
                        description: Product name or short description
                      WkImageUrl:
                        type: string
                        description: Product image URL
                      WkUrl:
                        type: string
                        description: Product page URL
                      WkPrice:
                        type: string
                        description: Original price
                      WkSalePrice:
                        type: string
                        description: Sale price
                      WkQuantity:
                        type: string
                        description: Number of items remaining in stock quantity
                      WkAdditionalProperties:
                        type: array
                        items:
                          properties:
                            key:
                              type: string
                              description: The key for the additional property
                            value:
                              type: string
                              description: The value for the additional property
                          type: object
                        description: Extension properties for the Signals Webhook that can be added during conversations with Wunderkind
                    type: object
                    required:
                    - WkId
                    - WkCopy
                    - WkImageUrl
                    - WkUrl
                  description: List of cart items/product recommendations (Max 4 are returned)
                WkAdditionalProperties:
                  type: array
                  items:
                    properties:
                      key:
                        type: string
                        description: The key for the additional property
                      value:
                        type: string
                        description: The value for the additional property
                    type: object
                  description: Extension properties for the Signals Webhook that can be added during conversations with Wunderkind
              type: object
              required:
              - WkPurpose
              - WkChannel
              - WkUserType
            examples:
              Sample Request:
                summary: Sample Request
                value:
                  Recipient: to@example.com
                  RecipientSha256: 01ebc948fa4c500ca1dc7b235ea2cadea0e534fe15d7035a1b31ae9d8a00029b
                  Origin: wunderkind
                  UserType: prospect
                  WkChannel: email
                  WkPurpose: cart abandonment
                  WKCouponCode: ''
                  WKCouponPurpose: ''
                  WkCartReplenishUrl: some-url.com
                  WkItems:
                  - WkCopy: Product name
                    WkId: '012345'
                    WkImageUrl: some-url.jpg
                    WkUrl: some-url.com
                    WkPrice: '34.77'
                    WkSalePrice: '24.77'
                    WkQuantity: '12'
                  - WkCopy: Product name
                    WkId: '012345'
                    WkImageUrl: some-url.jpg
                    WkUrl: some-url.com
                    WkAdditionalProperties:
                    - key: CategoryName
                      value: Toys
                  - WkCopy: Product name
                    WkId: '012345'
                    WkImageUrl: some-url.jpg
                    WkUrl: some-url.com
                  - WkCopy: Product name
                    WkId: '012345'
                    WkImageUrl: some-url.jpg
                    WkUrl: some-url.com
                  WkAdditionalProperties:
                  - key: CategoryName
                    value: Toys
      parameters:
      - name: Authorization
        in: header
        required: false
        description: Optionally include an authorization header to ensure only valid users are accessing your endpoint. Currently, `Bearer` and `Basic` are supported types of authorization.
        schema:
          type: string
          default: ''
      tags:
      - Wunderhook