> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.askelephant.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.askelephant.ai/_mcp/server.

# Engagement deleted

POST 

Fired when an engagement is deleted from the workspace.

Reference: https://docs.askelephant.ai/api-reference/webhook-events/engagement-deleted-webhook

## OpenAPI 3.1 Webhook Specification

```yaml
openapi: 3.1.0
info:
  title: AskElephant Public API
  version: 1.0.0
paths: {}
webhooks:
  engagement-deleted-webhook:
    post:
      operationId: engagement-deleted-webhook
      summary: Engagement deleted
      description: Fired when an engagement is deleted from the workspace.
      parameters:
        - name: svix-id
          in: header
          description: >-
            Unique identifier for this webhook delivery. Header names are
            case-insensitive.
          required: true
          schema:
            type: string
        - name: svix-timestamp
          in: header
          description: >-
            Unix timestamp used when verifying the webhook signature. Header
            names are case-insensitive.
          required: true
          schema:
            type: string
        - name: svix-signature
          in: header
          description: >-
            Signature for the raw webhook payload. Use this with the delivery
            ID, timestamp, and your endpoint secret to verify authenticity.
            Header names are case-insensitive.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Webhook received successfully
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/webhook_engagement_payload'
components:
  schemas:
    webhook_engagement_event_type:
      type: string
      enum:
        - v1.engagement.created
        - v1.engagement.updated
        - v1.engagement.deleted
        - v1.engagement.transcript_timeline.completed
      description: Event types emitted for engagement webhooks.
      title: webhook_engagement_event_type
    EngagementObject:
      type: string
      enum:
        - engagement
      title: EngagementObject
    EngagementEngagementType:
      type: string
      enum:
        - MEETING
        - CALL
        - EMAIL
        - TASK
        - NOTE
        - CALENDAR_EVENT
        - DOCUMENT
      title: EngagementEngagementType
    EngagementProcessingStatus:
      type: string
      enum:
        - PENDING
        - PROCESSING
        - COMPLETED
        - FAILED
      title: EngagementProcessingStatus
    crm_association:
      type: object
      properties:
        object_type:
          type: string
          description: CRM object type.
        crm_object_id:
          type: string
          description: The record ID in the source CRM system.
        source:
          type: string
          description: CRM source system.
      required:
        - object_type
        - crm_object_id
        - source
      title: crm_association
    EngagementCompanyObject:
      type: string
      enum:
        - engagement_company
      title: EngagementCompanyObject
    engagement_company:
      type: object
      properties:
        object:
          $ref: '#/components/schemas/EngagementCompanyObject'
        id:
          type: string
        name:
          type: string
        crm_association:
          $ref: '#/components/schemas/crm_association'
          description: >-
            CRM record linked to this company. Present when the company has been
            matched to a CRM record via integration or API.
        domains:
          type: array
          items:
            type: string
      required:
        - object
        - id
        - name
        - domains
      title: engagement_company
    ContactObject:
      type: string
      enum:
        - contact
      description: Resource discriminator for contact payloads.
      title: ContactObject
    resource_ref:
      type: object
      properties:
        id:
          type: string
        object:
          type: string
      required:
        - id
        - object
      title: resource_ref
    ContactEmailsItems:
      type: object
      properties:
        email:
          type: string
          format: email
          description: Contact email address.
        is_primary:
          type: boolean
          description: Indicates whether this is the primary email address.
      required:
        - email
        - is_primary
      title: ContactEmailsItems
    ContactPhoneNumbersItems:
      type: object
      properties:
        phone_number:
          type: string
          description: Contact phone number in the source-system format.
        is_primary:
          type: boolean
          description: Indicates whether this is the primary phone number.
      required:
        - phone_number
        - is_primary
      title: ContactPhoneNumbersItems
    contact:
      type: object
      properties:
        object:
          $ref: '#/components/schemas/ContactObject'
          description: Resource discriminator for contact payloads.
        id:
          type: string
          description: Stable AskElephant contact identifier.
        first_name:
          type:
            - string
            - 'null'
          description: Contact given name.
        last_name:
          type:
            - string
            - 'null'
          description: Contact family name.
        description:
          type: string
          description: Free-form contact summary or notes visible through the public API.
        company:
          $ref: '#/components/schemas/resource_ref'
          description: >-
            Lightweight reference to the contact's associated company when one
            exists.
        emails:
          type: array
          items:
            $ref: '#/components/schemas/ContactEmailsItems'
          description: Email addresses associated with the contact.
        phone_numbers:
          type: array
          items:
            $ref: '#/components/schemas/ContactPhoneNumbersItems'
          description: Phone numbers associated with the contact.
        crm_association:
          $ref: '#/components/schemas/crm_association'
          description: >-
            CRM record linked to this contact. Present when the contact has been
            matched to a CRM record via integration or API.
        time_zone:
          type: string
          description: IANA time zone identifier for the contact.
        created_at:
          type: string
          format: date-time
          description: Timestamp when the contact was first created in AskElephant.
        updated_at:
          type: string
          format: date-time
          description: Timestamp when the contact was most recently updated in AskElephant.
      required:
        - object
        - id
        - created_at
        - updated_at
      description: Public representation of a workspace contact.
      title: contact
    UserObject:
      type: string
      enum:
        - user
      title: UserObject
    UserRole:
      type: string
      enum:
        - OWNER
        - MANAGER
        - USER
        - INACTIVE
        - NOT_INVITED
      title: UserRole
    UserEmailsItems:
      type: object
      properties:
        email:
          type: string
          format: email
        is_primary:
          type: boolean
      required:
        - email
        - is_primary
      title: UserEmailsItems
    user:
      type: object
      properties:
        object:
          $ref: '#/components/schemas/UserObject'
        id:
          type: string
        first_name:
          type:
            - string
            - 'null'
        last_name:
          type:
            - string
            - 'null'
        job_title:
          type: string
        role:
          $ref: '#/components/schemas/UserRole'
        emails:
          type: array
          items:
            $ref: '#/components/schemas/UserEmailsItems'
        time_zone:
          type: string
        last_activity_at:
          type: string
          format: date-time
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - object
        - id
        - role
        - created_at
        - updated_at
      title: user
    EngagementActionItemObject:
      type: string
      enum:
        - engagement_action_item
      title: EngagementActionItemObject
    engagement_action_item:
      type: object
      properties:
        object:
          $ref: '#/components/schemas/EngagementActionItemObject'
        id:
          type: string
        title:
          type: string
        description:
          type: string
        due_on:
          type:
            - string
            - 'null'
        assigned_to_user_id:
          type:
            - string
            - 'null'
        assigned_to_user_name:
          type:
            - string
            - 'null'
        assigned_to_user_email:
          type:
            - string
            - 'null'
          format: email
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - object
        - id
        - title
        - description
        - created_at
        - updated_at
      title: engagement_action_item
    EngagementSignalObject:
      type: string
      enum:
        - engagement_signal
      title: EngagementSignalObject
    engagement_signal:
      type: object
      properties:
        object:
          $ref: '#/components/schemas/EngagementSignalObject'
        id:
          type: string
        annotation_definition_id:
          type: string
        name:
          type: string
        description:
          type:
            - string
            - 'null'
        data_type:
          type: string
        value:
          description: Any type
      required:
        - object
        - id
        - annotation_definition_id
        - name
        - data_type
        - value
      title: engagement_signal
    TagObject:
      type: string
      enum:
        - tag
      title: TagObject
    tag:
      type: object
      properties:
        object:
          $ref: '#/components/schemas/TagObject'
        id:
          type: string
        name:
          type: string
        hex_color:
          type:
            - string
            - 'null'
        description:
          type:
            - string
            - 'null'
        auto_tagging_enabled:
          type: boolean
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - object
        - id
        - name
        - created_at
        - updated_at
      title: tag
    engagement:
      type: object
      properties:
        object:
          $ref: '#/components/schemas/EngagementObject'
        id:
          type: string
        title:
          type: string
        description:
          type: string
        engagement_type:
          $ref: '#/components/schemas/EngagementEngagementType'
        data_source:
          type: string
        processing_status:
          $ref: '#/components/schemas/EngagementProcessingStatus'
        is_internal:
          type: boolean
        is_private:
          type: boolean
          description: Indicates whether the engagement is marked private in AskElephant.
        engagement_at:
          type: string
          format: date-time
        start_at:
          type: string
          format: date-time
        end_at:
          type: string
          format: date-time
        duration_seconds:
          type: integer
        meeting_url:
          type: string
          format: uri
        external_url:
          type: string
          description: >-
            URL linking back to this engagement in the originating external
            system (e.g. a dialer's call detail page). Accepts `https://`,
            `http://`, and custom app deep-link schemes such as
            `wavv://call/123`. Present only when the engagement was created with
            an `external_url` value.
        crm_association:
          $ref: '#/components/schemas/crm_association'
          description: >-
            CRM record linked to this engagement. Present when the engagement
            has been matched to a CRM record via integration or API.
        owner_user_id:
          type: string
        host_user_id:
          type: string
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        transcript:
          type:
            - string
            - 'null'
          description: >-
            Full text transcript of the engagement. Only included when `expand`
            contains `transcript`.
        media_url:
          type:
            - string
            - 'null'
          format: uri
          description: >-
            Temporary signed URL for downloading the engagement recording media.
            Only included when `expand` contains `media_url`. The URL expires
            after a short period.
        companies:
          type: array
          items:
            $ref: '#/components/schemas/engagement_company'
          description: >-
            Companies associated with this engagement. Only included when
            `expand` contains `companies`.
        contacts:
          type: array
          items:
            $ref: '#/components/schemas/contact'
          description: >-
            Contact participants associated with this engagement. Only included
            when `expand` contains `contacts`.
        owner:
          oneOf:
            - $ref: '#/components/schemas/user'
            - type: 'null'
          description: >-
            Workspace user who owns this engagement. Only included when `expand`
            contains `owner`.
        action_items:
          type: array
          items:
            $ref: '#/components/schemas/engagement_action_item'
          description: >-
            Action items created from this engagement. Only included when
            `expand` contains `action_items`.
        signals:
          type: array
          items:
            $ref: '#/components/schemas/engagement_signal'
          description: >-
            Signals (annotations) extracted from this engagement. Only included
            when `expand` contains `signals`.
        tags:
          type: array
          items:
            $ref: '#/components/schemas/tag'
          description: >-
            Tags applied to this engagement. Only included when `expand`
            contains `tags`.
      required:
        - object
        - id
        - title
        - engagement_type
        - processing_status
        - is_private
        - created_at
        - updated_at
      title: engagement
    WebhookEngagementPayloadDataPreviousAttributes:
      type: object
      properties: {}
      description: >-
        Only present on updated events. Contains the previous values of fields
        that changed.
      title: WebhookEngagementPayloadDataPreviousAttributes
    WebhookEngagementPayloadData:
      type: object
      properties:
        object:
          $ref: '#/components/schemas/engagement'
        previous_attributes:
          $ref: '#/components/schemas/WebhookEngagementPayloadDataPreviousAttributes'
          description: >-
            Only present on updated events. Contains the previous values of
            fields that changed.
      required:
        - object
      title: WebhookEngagementPayloadData
    webhook_engagement_payload:
      type: object
      properties:
        id:
          type: string
          description: Unique event identifier.
        type:
          $ref: '#/components/schemas/webhook_engagement_event_type'
        api_version:
          type: string
          description: API version used when the event was generated.
        created_at:
          type: string
          format: date-time
          description: Timestamp when the event was created.
        workspace_id:
          type: string
          description: Workspace that owns the resource.
        data:
          $ref: '#/components/schemas/WebhookEngagementPayloadData'
      required:
        - id
        - type
        - api_version
        - created_at
        - workspace_id
        - data
      description: >-
        Webhook payload delivered when an engagement is created, updated,
        deleted, or finishes processing.
      title: webhook_engagement_payload

```