Back to Subscriby

recovery.identity_relinked

The creator's sign-in account moved to another account on the connector: a newly detected one, or the backup switched in.

Ability to subscribeproject-recovery:view

When this fires

After a ban on the creator's own account, recovery moves their Subscriby identity to another account on the connector: one they prove control of through a handshake, or the backup account they registered ahead of time (from_backup: true). Sign-in and alerts follow the new account at once; the previous one becomes the backup when a backup was switched in. This is an account-level event: project_id is null and it reaches the endpoints of the team the creator owns.

Caveats

  • The platform's own account identifiers (numeric ids, usernames) are deliberately absent; identity_id is the neutral id the rest of the API uses.
  • Every browser session of the creator is signed out by the relink. The undo, inside 24 hours, fires recovery.operation_reverted and opens a relink_disputed incident.

Related events

  • recovery.operation_completed: the same recovery, as an operation.
  • recovery.operation_reverted: the relink undone.

Header Parameters

SB-Signature*string

t=<unix seconds>,v1=<hex>: the HMAC-SHA256 of "<t>.<raw body>" under the endpoint's secret. Verify it before acting, and refuse a t more than 300 seconds from now. During a secret rotation a v0= signature under the previous secret may precede v1=.

SB-Event-Id*string

The event's ULID, bare. The envelope's id is the same ULID prefixed evt_, so strip the prefix before comparing. Deduplicate on it: a retry carries the same id.

SB-Event-Name*string

The event name, the same as the envelope's type.

Content-Type*string

Always application/json.

User-Agent*string

Always Subscriby-Webhooks/1.0.

Request Body

application/json

The signed JSON envelope posted to your endpoint.

TypeScript Definitions

Use the request body type in TypeScript.

The envelope every event is delivered in.

Response Body

Example Requests

POST/recovery.identity_relinked

How is this guide?

recovery.resource_replaced Webhook

The creator pointed a resource at a replacement channel or group: in a recovery after a ban, or on demand for a healthy resource.

recovery.readiness_changed Webhook

A line of the Disaster Recovery readiness checklist changed state, and here is the whole checklist as it stands now.