---
title: "Send a signed `ping` event to a URL now"
method: POST
path: "/webhooks/test"
tags: ["Webhooks"]
---

# Send a signed \`ping\` event to a URL now

`POST /webhooks/test`

## Request

- Base URL: `https://api.songbrain.ai/v1`
- URL: `https://api.songbrain.ai/v1/webhooks/test`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Body `{"url": "https://…"}`. Signed with this key's webhook secret, exactly like real events. Returns whether your endpoint answered 2xx.

## Request body

- object
  - `url` string, uri, required

## Response `200`

Successful Response

- unknown

## Other responses

- `400`: Invalid request (bad JSON, missing audio, invalid parameters).
- `401`: Missing or invalid API key.
- `402`: Free songs used up and not enough credits.
- `404`: Not found on your account.
- `409`: Conflict (still processing, Idempotency-Key reused or in progress).
- `413`: Audio larger than 100 MB.
- `415`: Unsupported content type.
- `429`: Rate limited or pipeline busy; see Retry-After.
- `500`: Server error. Quote the request_id when you contact support.

---

[API](https://skmtc.dev/songbrain/apis/songbrain-api.md) · [All operations](https://skmtc.dev/songbrain/apis/songbrain-api/llms.txt) · [OpenAPI document](https://skmtc.dev/songbrain/apis/songbrain-api/revisions/f7021caafaed?raw)