Test a Slack notification webhook.
Send a test message to a Slack webhook
Deprecated: use POST /notifications/slack/verify instead. Removed on 2026-11-30.
Hits the supplied webhook URL with a test message so the org admin can confirm the URL is wired before saving it as the org's notification target. The URL is NOT persisted here - that's the org-settings endpoint's job.
Required scope: org.update (Update organization profile).
Headers
Idempotency-KeyUnique key that makes this POST safe to retry: repeats with the same key replay the first response instead of re-executing. Replays are scoped to the retrying principal (same API key / user) and kept for 24 hours. Required on every POST.
Client-generated idempotency key (e.g. a UUID).
X-Workspace-IdSelects the workspace this request operates in, by workspace UUID or slug (e.g. a sandbox workspace for test integrations). Omitted: the organization's default live workspace. Unknown workspace: 404; workspace outside your organization: 403. Discover workspaces via GET /workspaces.
Workspace UUID or slug.
Send a test message to a Slack webhook › Responses
OK
Verify a Slack webhook
Sends a test message to the supplied Slack webhook URL, so the URL can be checked before it is saved as the organization's notification target. The URL is not saved; save it with PUT /organization/settings.
Required scope: org.update (Update organization profile).
Headers
Idempotency-KeyUnique key that makes this POST safe to retry: repeats with the same key replay the first response instead of re-executing. Replays are scoped to the retrying principal (same API key / user) and kept for 24 hours. Required on every POST.
Client-generated idempotency key (e.g. a UUID).
X-Workspace-IdSelects the workspace this request operates in, by workspace UUID or slug (e.g. a sandbox workspace for test integrations). Omitted: the organization's default live workspace. Unknown workspace: 404; workspace outside your organization: 403. Discover workspaces via GET /workspaces.
Workspace UUID or slug.
Verify a Slack webhook › Responses
OK