Skip to main content
POST
Create a webhook subscription

Authorizations

Authorization
string
header
required

Firebase Auth JWT issued by Google Identity Platform. Obtain a token by signing in at your app domain and calling firebase.auth().currentUser.getIdToken().

Body

application/json
tenant_id
string
required
target_url
string<uri>
required

HTTPS endpoint to receive webhook deliveries.

event_types
string[]
required

Domain event types to subscribe to. Known event types: snapshot.created, update.proposed, update.applied, refresh_request.created, refresh_request.fulfilled.

Minimum array length: 1

Response

Subscription created. Secret returned once.

webhook_subscription
object
secret
string

Plaintext HMAC-SHA256 signing secret. Not stored by Tally — this is the only time it is returned. Use it to verify x-tally-signature on incoming webhook deliveries.