Skip to content
builders.ac

Mailbox API · Beta

Create an event webhook subscription — NOT YET AVAILABLE

Deprecated
POST
/events/subscriptions
curl --request POST \
  --url https://api.builders.ac/api/mailbox/v1beta1/events/subscriptions

Not yet available. This endpoint is not routed. Calling it today returns 404.

Planned: push delivery of the same events as GET /events, so you can react without polling.

No request or response shape is committed yet. Do not implement against it.

Responses

Section titled “Responses”

404

Section titled “404”

Not routed. This endpoint does not exist yet; the Events surface returns an RFC 9457 problem.

Media typeapplication/problem+json
Problem

An RFC 9457 problem. Branch on code.

object
type
required

The catalogue entry for code, under /problems.

string format: uri
title
required
string
status
required
integer
detail
required
string
code
required
string
retryable
required
boolean
correlation_id
required

Quote this in support requests. Also sent as x-correlation-id.

string
retry_after

Present on 429: when to retry.

string format: date-time
errors

Per parameter, what is wrong with it.

object
key
additional properties
Array<string>
Examplegenerated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "retryable": true,
  "correlation_id": "example",
  "retry_after": "2026-04-15T12:00:00Z",
  "errors": {
    "additionalProperty": [
      "example"
    ]
  }
}