Skip to main content
GET /v1/issuer/automations/{automation_id}/webhook API Key

Get webhook configuration

Get the webhook trigger URL and token for an automation.

Use case: Configure external systems (HR software, LMS, etc.) to call the trigger_url
when data changes, automatically issuing credentials.

The trigger_url includes the token and can be called without API key authentication.
The automation must have trigger_mode: webhook and status: active for triggers to work.

Parameters

Name Location Type Description
automation_id * path string Automation ID
X-API-Key * header string Issuer API key for authentication

* Required parameter

Response

200 Webhook configuration

Content-Type: application/json

success boolean
data object

Webhook configuration for an automation

automation_id * string

The automation's unique identifier

Example: abc123xyz

automation_name * string

Display name of the automation

Example: Daily Badge Sync

trigger_url * string (uri)

Full URL to POST to trigger the automation

Example: https://api.aho.com/v1/hooks/automations/X_byFjHECwqaJccMOWumqjyJSNxZlEvV2JWL9XvF5VU

token * string

The webhook token (included in trigger_url)

Example: 32kbCpE2jTBD9ygyPOdcsIGIXpMLWvem0_0fOkydyks

generated_at string (date-time) nullable

When the token was generated

Example: 2025-01-15T10:00:00Z

trigger_mode * string

Current trigger mode of the automation

Allowed values: "manual", "scheduled", "webhook"

Example: webhook

enabled * boolean

Whether webhook triggers are allowed (true when trigger_mode=webhook and status=active)

Example: true

Code Examples

import os
from aho_sdk import AhoSdk

client = AhoSdk.issuer(api_key=os.environ["AHO_API_KEY"])

result = client.automations.get_webhook(
    automation_id="example_automation_id"
)

Try It

Log in to test this endpoint directly from the documentation.

Log in