> ## Documentation Index > Fetch the complete documentation index at: https://docs.revcenter.ai/llms.txt > Use this file to discover all available pages before exploring further. # Send a test event > Send a webhook.test event to one endpoint now, signed like any other, and return the delivery with the status code your endpoint answered. Sent once and not retried. Works on an endpoint that is turned off, so you can check it before turning it back on. Does not use credits. Needs scope `webhooks:write`. ## OpenAPI ````yaml /openapi.json post /webhooks/{webhookId}/test openapi: 3.1.0 info: title: Revcenter API version: v1 description: >- Projects, searches, scored candidates and shortlists. Generated from the agent API's registry. servers: - url: https://api.revcenter.ai/v1 security: - bearer: [] tags: - name: Login - name: Account - name: Actions - name: Reference - name: Projects - name: Searches - name: Scoring - name: Shortlists - name: Candidates - name: Webhooks - name: Health paths: /webhooks/{webhookId}/test: post: tags: - Webhooks summary: Send a test event description: >- Send a webhook.test event to one endpoint now, signed like any other, and return the delivery with the status code your endpoint answered. Sent once and not retried. Works on an endpoint that is turned off, so you can check it before turning it back on. Does not use credits. Needs scope `webhooks:write`. operationId: test_webhook parameters: - name: webhookId in: path required: true description: A webhook id schema: type: string responses: '200': description: OK headers: X-RateLimit-Limit: description: >- Requests allowed this minute (the tighter of the key's and the workspace's). schema: type: integer X-RateLimit-Remaining: description: Requests left this minute. schema: type: integer X-RateLimit-Reset: description: When the minute resets, in Unix seconds. schema: type: integer content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/WebhookDelivery' meta: $ref: '#/components/schemas/Meta' example: data: id: 2f1e0d9c-8b7a-4e6d-9c5b-4a3f2e1d0c9b webhook_id: 5e4d3c2b-1a09-4f8e-9d7c-6b5a4f3e2d1c event_id: evt_4b1d0c9e8f7a6b5c4d3e2f1a0b9c8d7e event_type: webhook.test status: delivered attempt: 1 response_status: 200 response_ms: 184 error: null next_attempt_at: null created_at: '2026-10-17T14:19:41.000Z' delivered_at: '2026-10-17T14:19:41.000Z' redelivery_of: null payload: id: evt_4b1d0c9e8f7a6b5c4d3e2f1a0b9c8d7e type: webhook.test created_at: '2026-10-17T14:19:41.000Z' workspace_id: org_2xAmpLe api_version: '2026-10-19' data: webhook_id: 5e4d3c2b-1a09-4f8e-9d7c-6b5a4f3e2d1c message: A test event from Revcenter. meta: request_id: req_01JABCDEF '400': $ref: '#/components/responses/Error' '401': $ref: '#/components/responses/Error' '402': $ref: '#/components/responses/Error' '403': $ref: '#/components/responses/Error' '404': $ref: '#/components/responses/Error' '409': $ref: '#/components/responses/Error' '429': $ref: '#/components/responses/Error' '500': $ref: '#/components/responses/Error' '503': $ref: '#/components/responses/Error' components: schemas: WebhookDelivery: type: object properties: id: type: string webhook_id: type: string event_id: type: string description: 'The same on every retry and redelivery: deduplicate on it.' event_type: type: string status: type: string enum: - pending - delivered - failed - abandoned description: >- failed: the last attempt failed and another is scheduled (next_attempt_at). abandoned: no more attempts. attempt: type: integer description: Attempts made. response_status: type: - integer - 'null' description: >- The HTTP status your endpoint answered; null when it could not be reached. response_ms: type: - integer - 'null' error: type: - string - 'null' next_attempt_at: type: - string - 'null' created_at: type: string delivered_at: type: - string - 'null' redelivery_of: type: - string - 'null' description: The delivery this one repeats. payload: $ref: '#/components/schemas/WebhookEvent' Meta: type: object properties: request_id: type: string total: type: integer description: On lists that count everything that matched. WebhookEvent: type: object description: >- What each delivery POSTs. data carries ids, counts and links, never profiles or contact details; read those through the links. properties: id: type: string type: type: string created_at: type: string workspace_id: type: string api_version: type: string enum: - '2026-10-19' data: type: object Error: type: object required: - error properties: error: type: object required: - code - message - request_id properties: code: type: string description: 'Stable: every code is on the Errors page.' message: type: string details: type: - object - 'null' description: >- Structured specifics, when there are any (for example retry_after_seconds). request_id: type: string meta: $ref: '#/components/schemas/Meta' example: error: code: search_not_found message: No search with that id in this workspace. details: null request_id: req_01JABCDEF meta: request_id: req_01JABCDEF responses: Error: description: 'An error: one envelope everywhere. A 429 carries Retry-After.' headers: X-RateLimit-Limit: description: >- Requests allowed this minute (the tighter of the key's and the workspace's). schema: type: integer X-RateLimit-Remaining: description: Requests left this minute. schema: type: integer X-RateLimit-Reset: description: When the minute resets, in Unix seconds. schema: type: integer Retry-After: description: Seconds to wait (on 429 and 503). schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearer: type: http scheme: bearer description: An API key from Settings → Usage → API (rvc_live_…). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.