Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.perscom.io/llms.txt

Use this file to discover all available pages before exploring further.

Webhooks send HTTP requests to external URLs when events occur in PERSCOM. Use webhooks to integrate with messaging platforms like Slack, Telegram, or Discord, sync data with external databases, or trigger custom workflows in your applications.

​
Use Cases

Webhooks enable you to:
  • Send notifications to Discord or Slack when users are created or updated
  • Sync personnel changes to external databases like Firebase or AWS
  • Trigger custom reporting tools when records change
  • Build real-time dashboards that reflect PERSCOM data

​
Create A Webhook

  1. In the sidebar, select Integrations > Webhooks.
  2. Select New webhook.
  3. Enter a Name to identify the webhook.
  4. Enter the URL that receives webhook requests.
  5. Select the Method (GET or POST).
  6. Enter a Secret to sign requests for verification.
  7. Select the Events that trigger this webhook.
  8. Select Create.

​
Request Verification

Each webhook request includes a Signature header containing an HMAC signature. Use this signature to verify that requests originate from PERSCOM and haven’t been tampered with. To verify a request:
  1. Extract the Signature header from the incoming request.
  2. Compute an HMAC-SHA256 hash of the request body using your webhook secret.
  3. Compare your computed signature with the Signature header.

​
Events

Webhooks can subscribe to any of the following events:
EventDescription
user.createdA new user was created
user.updatedA user was updated
user.deletedA user was deleted

​
Webhook Logs

PERSCOM logs all webhook requests for debugging purposes. To view logs:
  1. In the sidebar, select Integrations > Webhooks.
  2. Select a webhook to view its details.
  3. Review the Logs section to see request history, including status codes and response times.

​
Automations

For more advanced webhook workflows with conditional logic and custom payloads, see Automations. Automations allow you to:
  • Add conditions to control when webhooks fire
  • Customize the JSON payload sent to external services
  • Use Twig templates for dynamic content