> ## Documentation Index
> Fetch the complete documentation index at: https://developers.ever.day/llms.txt
> Use this file to discover all available pages before exploring further.

# Receive Webhook Events

> Everday will send a POST request to this endpoint whenever a relevant event occurs. Clients must implement a listener to process these events.




## OpenAPI

````yaml post /webhook
openapi: 3.0.3
info:
  title: Everday Webhook API
  version: 1.0.0
  description: >
    ## Webhook API

    Everday sends webhook events when key actions occur, such as onboarding
    updates, profile creation, and smart match generation.


    - Clients must configure a webhook endpoint to receive these events.

    - Webhooks will be sent as POST requests to the provided URL.

    - Each request includes an event type within the data payload.
servers: []
security: []
paths:
  /webhook:
    post:
      summary: Receive Webhook Events
      description: >
        Everday will send a POST request to this endpoint whenever a relevant
        event occurs. Clients must implement a listener to process these events.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - $ref: '#/components/schemas/OnboardingUpdated'
                  title: OnboardingUpdated
                - $ref: '#/components/schemas/ProfileCreated'
                  title: ProfileCreated
                - $ref: '#/components/schemas/SmartMatchCreated'
                  title: SmartMatchCreated
      responses:
        '200':
          description: Webhook received successfully.
        '400':
          description: Invalid request payload.
        '401':
          description: Unauthorized. API key is missing or invalid.
        '500':
          description: Internal server error.
      security:
        - apiKeyAuth: []
components:
  schemas:
    OnboardingUpdated:
      title: Onboarding Updated
      type: object
      properties:
        event:
          type: string
          enum:
            - onboarding.updated
          description: The type of webhook event.
        data:
          type: object
          properties:
            status:
              type: string
              enum:
                - PENDING
                - INITIATED
                - COMPLETED
              description: The current status of the onboarding.
            publicIdentifier:
              type: string
              description: The public identifier of the user.
    ProfileCreated:
      title: Profile Created
      type: object
      properties:
        event:
          type: string
          enum:
            - profile.created
          description: The type of webhook event.
        data:
          type: object
          properties:
            publicIdentifier:
              type: string
              description: The public identifier of the user.
            createdAt:
              type: string
              format: date-time
              description: Timestamp of when the profile was created.
    SmartMatchCreated:
      title: Smart Match Created
      type: object
      properties:
        event:
          type: string
          enum:
            - smart_match.created
          description: The type of webhook event.
        data:
          type: object
          properties:
            publicIdentifier:
              type: string
              description: The ID of the passport that was matched.
            skillsetId:
              type: string
              description: The ID of the skillset used in the match.
            createdAt:
              type: string
              format: date-time
              description: Timestamp of when the smart match was created.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key required to receive webhooks.

````