Skip to main content
POST
/
v1
/
webhook-subscriptions
/
{subscription_id}
/
rotate-secret
Rotate webhook signing secret
curl --request POST \
  --url https://tally-platform-api-xwka6vu2kq-ue.a.run.app/v1/webhook-subscriptions/{subscription_id}/rotate-secret \
  --header 'Authorization: Bearer <token>'
{
  "webhook_subscription": {
    "subscription_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "tenant_id": "<string>",
    "target_url": "<string>",
    "subscribed_event_types": [
      "<string>"
    ],
    "secret_last_rotated_at": "2023-11-07T05:31:56Z",
    "disabled_at": "2023-11-07T05:31:56Z",
    "created_at": "2023-11-07T05:31:56Z"
  },
  "secret": "<string>"
}

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().

Path Parameters

​
subscription_id
string<uuid>
required

Query Parameters

​
tenant_id
string
required

Response

New secret returned.

​
webhook_subscription
object
​
secret
string

New plaintext signing secret. Store it securely.