v1

latestOpenAPI 3.0.3Proprietary2026-08-0656136286.9 KB
Webhooks

Regenerate Account Secret

Regenerate the account webhook secret. Affects all subscriptions for the account.

Endpoint: (POST) https://api.lusha.com/api/account/secret/regenerate

Behavior:

  • If a secret already exists: Replaces with new secret (old secret is invalidated)
  • If no secret exists: Creates new secret automatically

Important Notes:

  • The secret is only shown once in the response. Store it securely.
  • This endpoint always succeeds (upsert operation)
  • Regenerating invalidates the old secret for all subscriptions (if one existed)
  • An account secret must exist before webhooks can be delivered
post/api/account/secret/regenerate

Response

Account secret regenerated successfully

secretstring required

Newly generated account webhook secret (store securely - only shown once)

Example response

{
  "secret": "whsec_new_secret_here_abc123def456ghi789jkl012mno345"
}