Autional Autional
API Reference GitHub autional.com →

POST /admin/tenants/{tenant_id}/webhooks

Register an event callback Webhook for a tenant

Tenant Service `bearerAuth` application/json

Request Parameters

NameInTypeRequiredDefaultExampleConstraintsDescription
id path string Yes Tenant ID

Request Body

Schema: dto.CreateWebhookRequest

FieldTypeRequiredExampleConstraintsDescription
backoff_strategy domain.WebhookBackoffStrategy No
events array of

string

No
headers object No extra keys: `string`
max_retries integer No
secret string No
timeout_secs integer No
url string No

Responses

StatusDescriptionSchema
201Creation successfuldto.WebhookDetailResponse
400Invalid request parametersgitee_com_linmes_authms_base_dto.SimpleResponse
401Unauthenticatedgitee_com_linmes_authms_base_dto.SimpleResponse
403Insufficient permissionsgitee_com_linmes_authms_base_dto.SimpleResponse
409Resource conflictgitee_com_linmes_authms_base_dto.SimpleResponse
500Internal server errorgitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

domain.WebhookBackoffStrategy

string

dto.WebhookDetailResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
data dto.WebhookResponse No
message string No
timestamp string No

dto.WebhookResponse

FieldTypeRequiredExampleConstraintsDescription
backoff_strategy string No exponential
created_at string No 2026-01-01T00:00:00Z
events array of

string

No ['["user.created"', '"user.updated"]']
headers string No {"X-Custom":"value"}
id string No 550e8400-e29b-41d4-a716-446655440000
is_active boolean No True
max_retries integer No 3
tenant_id string No tenant-123
timeout_secs integer No 10
updated_at string No 2026-01-01T00:00:00Z
url string No https://example.com/webhook

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No