Create a subscription
POST/subscriptions
Creates a subscription that delivers change events for one property or company as signed CloudEvents 1.0 webhooks. Idempotency-Key replays the same response to a retried request for 24 hours.
Each delivery is a CloudEvents 1.0 envelope: specversion "1.0",
a type like "no.placepoint.property.owner_changed", source
identifying the subscription, id, time and data holding the
changed resource. The request carries a Placepoint-Signature
header shaped t=<unix-timestamp>,v1=<hex-signature>, where
signature is the hex-encoded HMAC-SHA256, keyed on secret, of
the string formed by joining t and the raw request body with
a period. The receiver can verify authenticity before
trusting the payload. A failed delivery
retries with exponential backoff for up to 24 hours; delivery
is at-least-once, so a receiver must handle a duplicate event
by id.
Produktside: Varsler.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 429
- 500
The created subscription.
The request body or a parameter failed validation.
The bearer token is missing, expired or invalid.
The token lacks the scope this operation needs.
No such resource in the served registers.
Rate limit or daily quota exceeded; see the RateLimit headers.
Something failed on our side; quote traceId to support.