Social API reference

Social API · Webhooks

post/v1/communities/{community_id}/webhooks/{webhook_id}/testAuth

Send a test delivery now: the example of the first event type the webhook subscribes to, signed exactly like a real event. The answer (202, kept for compatibility) already carries the outcome: `status` is `succeeded` or `exhausted` (never retried), with `last_error`.

Deprecated: use `/v1/communities/{community_id}/webhooks/endpoints` (or `/v1/workspaces/{workspace_id}/webhooks/endpoints` for one endpoint that receives every community's events): Standard Webhooks signing, event descriptions, Send test that reports the result, an event log, replay and rotation with a grace period. Responses carry `Deprecation: true` and `Sunset: Fri, 15 Jan 2027 00:00:00 GMT`.

Path parameters

community_id*string

Social community UUID.

webhook_id*string

Webhook UUID.

Response · 202 Test sent; the outcome is in `status`.

id*string · uuid

Id of the delivery attempt (shows in the deliveries list).

webhook_id*string · uuid

Webhook UUID the job targets.

event_id*string

Stable event id (carried in the request body as `id`; stable across retries and redelivers).

Example: "evt_…"

event_type*string

Event type that was sent.

Example: "post.created"

status*enum (5)

Job state.

Example: "pending"

attempt_count*number

Delivery attempts made so far.

Example: 0

next_attempt_at*string · date-time

ISO timestamp of the next scheduled attempt (backoff: 1m, 5m, 30m, 2h, 6h, 24h).

Example: "2026-05-01T12:00:00.000Z"

last_error*string

Error from the most recent failed attempt. Null before the first failure.

Example: null

created_at*string · date-time

ISO timestamp.

Example: "2026-05-01T12:00:00.000Z"

updated_at*string · date-time

ISO timestamp.

Example: "2026-05-01T12:00:00.000Z"

Example

Request

POST https://social.productcraft.co/v1/communities/{community_id}/webhooks/{webhook_id}/test
Authorization: Bearer YOUR_TOKEN

Response

{
  "id": "00000000-0000-0000-0000-000000000000",
  "webhook_id": "00000000-0000-0000-0000-000000000000",
  "event_id": "evt_…",
  "event_type": "post.created",
  "status": "pending",
  "attempt_count": 0,
  "next_attempt_at": "2026-05-01T12:00:00.000Z",
  "last_error": null,
  "created_at": "2026-05-01T12:00:00.000Z",
  "updated_at": "2026-05-01T12:00:00.000Z"
}