> ## Documentation Index
> Fetch the complete documentation index at: https://www.quo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Send a test event to a webhook

> Dispatches a canonical sample payload of the specified event type to the webhook URL so you can validate your endpoint before going live. The response returns the rendered sample payload so you can preview the body your endpoint will receive. Delivery to your URL is processed asynchronously; use the delivery detail endpoint to inspect the attempt.



## OpenAPI

````yaml https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-2026-03-30-prod.json post /webhooks/{webhookId}/events/test
openapi: 3.1.0
info:
  title: Quo Public API
  version: 1.0.0
  description: API for connecting with Quo.
  contact:
    name: Quo Support
    email: support@quo.com
    url: https://support.quo.com/
  termsOfService: https://www.quo.com/terms
servers:
  - description: Production server
    url: https://api.quo.com
security:
  - apiKey: []
tags:
  - description: Operations related to calls
    name: Calls
  - description: >-
      Operations related to call summaries, including AI-generated summaries and
      Sona voice assistant summaries
    name: Call Summaries
  - description: >-
      Operations related to call transcripts, including AI-generated transcripts
      and Sona voice assistant transcripts
    name: Call Transcripts
  - description: Operations related to contacts
    name: Contacts
  - description: Operations related to conversations
    name: Conversations
  - description: Operations related to text messages
    name: Messages
  - description: Operations related to phone numbers
    name: Phone Numbers
  - description: Operations related to users
    name: Users
  - description: Operations related to webhooks
    name: Webhooks
paths:
  /webhooks/{webhookId}/events/test:
    post:
      tags:
        - Webhooks
      summary: Send a test event to a webhook
      description: >-
        Dispatches a canonical sample payload of the specified event type to the
        webhook URL so you can validate your endpoint before going live. The
        response returns the rendered sample payload so you can preview the body
        your endpoint will receive. Delivery to your URL is processed
        asynchronously; use the delivery detail endpoint to inspect the attempt.
      operationId: sendHeaderVersionedTestWebhookEvent
      parameters:
        - in: path
          name: webhookId
          required: true
          schema:
            description: The unique identifier of a webhook
            examples:
              - '123'
            pattern: ^[0-9]+$
            type: string
          example: '123'
        - in: header
          name: Quo-Api-Version
          required: true
          schema:
            type: string
            enum:
              - '2026-03-30'
            description: 'API version header. Supported values: 2026-03-30'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - eventType
              properties:
                eventType:
                  type: string
                  enum:
                    - call.answered
                    - call.completed
                    - call.forwarded
                    - call.menu.selected
                    - call.missed
                    - call.ringing
                    - call.recording.completed
                    - call.summary.completed
                    - call.transcript.completed
                    - call.voicemail.completed
                    - message.received
                    - message.delivered
                    - message.failed
                    - message.undelivered
                    - contact.updated
                    - contact.deleted
                    - task.assigned
                    - task.created
                    - task.completed
                    - task.updated
                    - task.deleted
                    - task.unassigned
                    - task.reopened
                    - task.duedate.removed
                    - task.duedate.updated
                    - task.overdue
                    - task.linked
                    - task.unlinked
                  description: Event type
                  examples:
                    - call.completed
                  example: call.completed
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - apiVersion
                  - type
                  - createdAt
                  - data
                properties:
                  id:
                    description: >-
                      The event identifier inside the dispatched payload body —
                      matches the `id` your endpoint will receive on the webhook
                      POST. Note: this is a fixed sample identifier shared
                      across test dispatches, not a per-delivery Svix message
                      ID.
                    examples:
                      - msg_2abcDEFghiJKLmnoPQRstu
                    type: string
                    example: msg_2abcDEFghiJKLmnoPQRstu
                  apiVersion:
                    type: string
                    enum:
                      - '2026-03-30'
                    description: The webhook payload version used to render this event.
                    examples:
                      - '2026-03-30'
                    example: '2026-03-30'
                  type:
                    type: string
                    enum:
                      - call.answered
                      - call.completed
                      - call.forwarded
                      - call.menu.selected
                      - call.missed
                      - call.ringing
                      - call.recording.completed
                      - call.summary.completed
                      - call.transcript.completed
                      - call.voicemail.completed
                      - message.received
                      - message.delivered
                      - message.failed
                      - message.undelivered
                      - contact.updated
                      - contact.deleted
                      - task.assigned
                      - task.created
                      - task.completed
                      - task.updated
                      - task.deleted
                      - task.unassigned
                      - task.reopened
                      - task.duedate.removed
                      - task.duedate.updated
                      - task.overdue
                      - task.linked
                      - task.unlinked
                    description: Event type
                    examples:
                      - call.completed
                    example: call.completed
                  createdAt:
                    format: date-time
                    description: When the test event was created.
                    type: string
                  data:
                    description: >-
                      Event-specific body. Shape depends on `type` — see the
                      webhook event documentation.
                    examples:
                      - context:
                          contacts:
                            ids:
                              - CTsampleContact01234
                            lookupStatus: matched
                          conversationId: CNsampleconversation000000000000
                          participants:
                            external:
                              - '+15555551234'
                            resolution: available
                            workspace:
                              - '+15555555678'
                          phoneNumberId: PNsamplephonenumber000000000000
                          phoneNumberType: shared
                          userId: USsampleus
                        links:
                          quo: >-
                            https://my.quo.com/inbox/PNsamplephonenumber000000000000/c/CNsampleconversation000000000000?at=ACsampleactivity0000000000000000
                        resource:
                          answeredAt: '2026-03-30T18:00:00.000Z'
                          completedAt: '2026-03-30T18:00:00.000Z'
                          createdAt: '2026-03-30T18:00:00.000Z'
                          direction: incoming
                          duration: 42
                          hasVoicemail: false
                          id: ACsampleactivity0000000000000000
                          status: answered
                          updatedAt: '2026-03-30T18:00:00.000Z'
                    example:
                      context:
                        contacts:
                          ids:
                            - CTsampleContact01234
                          lookupStatus: matched
                        conversationId: CNsampleconversation000000000000
                        participants:
                          external:
                            - '+15555551234'
                          resolution: available
                          workspace:
                            - '+15555555678'
                        phoneNumberId: PNsamplephonenumber000000000000
                        phoneNumberType: shared
                        userId: USsampleus
                      links:
                        quo: >-
                          https://my.quo.com/inbox/PNsamplephonenumber000000000000/c/CNsampleconversation000000000000?at=ACsampleactivity0000000000000000
                      resource:
                        answeredAt: '2026-03-30T18:00:00.000Z'
                        completedAt: '2026-03-30T18:00:00.000Z'
                        createdAt: '2026-03-30T18:00:00.000Z'
                        direction: incoming
                        duration: 42
                        hasVoicemail: false
                        id: ACsampleactivity0000000000000000
                        status: answered
                        updatedAt: '2026-03-30T18:00:00.000Z'
        '400':
          description: Invalid Input Format
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - code
                  - status
                  - docs
                  - title
                  - description
                properties:
                  message:
                    type: string
                  code:
                    const: '0304400'
                    type: string
                  status:
                    const: 400
                    type: number
                  docs:
                    const: https://quo.com/docs
                    type: string
                  title:
                    const: Invalid Input Format
                    type: string
                  trace:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      required:
                        - path
                        - message
                        - schema
                      properties:
                        path:
                          type: string
                        message:
                          type: string
                        value: {}
                        schema:
                          type: object
                          required:
                            - type
                          properties:
                            type:
                              type: string
                  description:
                    const: Invalid Input Format
                    type: string
              example:
                message: Invalid input format
                docs: https://quo.com/docs
                title: Invalid Input Format
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - code
                  - status
                  - docs
                  - title
                properties:
                  message:
                    type: string
                  code:
                    const: '0300401'
                    type: string
                  status:
                    const: 401
                    type: number
                  docs:
                    const: https://quo.com/docs
                    type: string
                  title:
                    const: Unauthorized
                    type: string
                  trace:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      required:
                        - path
                        - message
                        - schema
                      properties:
                        path:
                          type: string
                        message:
                          type: string
                        value: {}
                        schema:
                          type: object
                          required:
                            - type
                          properties:
                            type:
                              type: string
              example:
                message: You are unauthorized to access the webhook
                docs: https://quo.com/docs
                title: Unauthorized
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - code
                  - status
                  - docs
                  - title
                properties:
                  message:
                    type: string
                  code:
                    const: '0300403'
                    type: string
                  status:
                    const: 403
                    type: number
                  docs:
                    const: https://quo.com/docs
                    type: string
                  title:
                    const: Forbidden
                    type: string
                  trace:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      required:
                        - path
                        - message
                        - schema
                      properties:
                        path:
                          type: string
                        message:
                          type: string
                        value: {}
                        schema:
                          type: object
                          required:
                            - type
                          properties:
                            type:
                              type: string
              example:
                message: You are forbidden to access the webhook
                docs: https://quo.com/docs
                title: Forbidden
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - code
                  - status
                  - docs
                  - title
                properties:
                  message:
                    type: string
                  code:
                    const: '0300404'
                    type: string
                  status:
                    const: 404
                    type: number
                  docs:
                    const: https://quo.com/docs
                    type: string
                  title:
                    const: Not Found
                    type: string
                  trace:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      required:
                        - path
                        - message
                        - schema
                      properties:
                        path:
                          type: string
                        message:
                          type: string
                        value: {}
                        schema:
                          type: object
                          required:
                            - type
                          properties:
                            type:
                              type: string
              example:
                message: Webhook with ID 123 not found
                docs: https://quo.com/docs
                title: Not Found
        '500':
          description: Unknown Error
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - code
                  - status
                  - docs
                  - title
                properties:
                  message:
                    type: string
                  code:
                    const: '0301500'
                    type: string
                  status:
                    const: 500
                    type: number
                  docs:
                    const: https://quo.com/docs
                    type: string
                  title:
                    const: Unknown
                    type: string
                  trace:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      required:
                        - path
                        - message
                        - schema
                      properties:
                        path:
                          type: string
                        message:
                          type: string
                        value: {}
                        schema:
                          type: object
                          required:
                            - type
                          properties:
                            type:
                              type: string
              example:
                message: An unknown error occurred
                docs: https://quo.com/docs
                title: Unknown Error
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      in: header
      name: Authorization
      type: apiKey

````