# Email to HEM

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /lead/resolution/email_to_hem:
    post:
      summary: Email to HEM
      deprecated: false
      description: >
        <p>The privacy-safe activation layer. Email To HEM converts your
        existing email lists into the universal hashed email format every major
        ad platform and identity graph speaks. Required for Meta Advantage+,
        Google Customer Match, LinkedIn Matched Audiences, and clean-room
        workflows. Bulk and real-time options available.</p>
      operationId: resolveEmailToHEM
      tags:
        - 👤  Lead Resolution
        - Resolution
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              x-apidog-refs:
                01KMJN215J0DMMQRVDPEGM4WM9:
                  $ref: '#/components/schemas/EmailToHEMRequest'
                  x-apidog-overrides:
                    metadata: null
              x-apidog-orders:
                - 01KMJN215J0DMMQRVDPEGM4WM9
              properties:
                email:
                  type: string
                  format: email
                  description: >-
                    The person's email address. This can be a work or personal
                    email address.
                  examples:
                    - john@acme.com
                callback_url:
                  type: string
                  format: uri
                  examples:
                    - https://webhook.site/your-id
                  description: 'URL where the result will be posted asynchronously '
              required:
                - email
                - callback_url
              x-apidog-ignore-properties:
                - email
                - callback_url
            example:
              email: john@acme.com
              callback_url: https://webhook.site/your-id
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: boolean
                  message:
                    type: string
                required:
                  - data
                  - message
                x-apidog-orders:
                  - data
                  - message
                x-apidog-ignore-properties: []
              example:
                success: true
                message: Resolution successfully completed!
                resolution:
                  id: res_64a17cd62747017905c76aa06e98d5f4
                  status: completed
                  requested_at: '2026-05-29T12:42:24.107Z'
                  callback_url: https://webhook.site/your-id
                lead:
                  hashed_emails:
                    - email: 40d8a52f7ba59aa94eed65876da6d249
                      type: md5
                  linkedin_url: linkedin.com/in/john-doe
                payload:
                  email: john@acme.com
                  callback_url: https://webhook.site/your-id
          headers: {}
          x-apidog-name: ''
        '400':
          description: Invalid email or insufficient credits
          headers: {}
          x-apidog-name: ''
      security: []
      x-apidog-folder: 👤  Lead Resolution
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1235890/apis/api-31382860-run
components:
  schemas:
    EmailToHEMRequest:
      type: object
      description: >-
        Convert an email to hashed format (HEM) for advertising platforms.
        Requires callback_url.
      required:
        - email
        - callback_url
      properties:
        email:
          type: string
          format: email
          description: >-
            The person's email address. This can be a work or personal email
            address.
          examples:
            - john@acme.com
        callback_url:
          type: string
          format: uri
          examples:
            - https://webhook.site/your-id
          description: 'URL where the result will be posted asynchronously '
      x-apidog-orders:
        - email
        - callback_url
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes:
    bearerAuth:
      type: jwt
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Organization JWT or API key from Core API. Send in header:
        Authorization: Bearer {token}
    sysAuth:
      type: apikey
      in: header
      name: x-sys-key
      description: >-
        System authentication key for internal endpoints. Only for inter-service
        calls.
servers:
  - url: https://api.lead.springbolt.app
    description: Prod Env
security: []

```