Configure the prior-authorization webhook

import requests
url = "https://api.taigabilling.com/api/prior-authorizations/v1/webhook-endpoint"
payload = { "url": "string" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.json())

{
  "abandoned_event_count": 1,
  "enabled": true,
  "latest_event": {
    "abandoned_at": "2024-01-15T09:30:00Z",
    "attempts": 1,
    "created_at": "2024-01-15T09:30:00Z",
    "delivered_at": "2024-01-15T09:30:00Z",
    "event_id": "string",
    "event_type": "prior_authorization.received",
    "last_attempt_at": "2024-01-15T09:30:00Z",
    "last_error_code": "string",
    "last_http_status": 1,
    "status": "PENDING"
  },
  "signing_secret": "string",
  "url": "string"
}

Registers one HTTPS callback for the organization. Status events are signed and retried with exponential backoff.

Authentication

AuthorizationBearer

Send your Taiga API key as a Bearer token. Create and manage keys in the Taiga developer portal.

Request

This endpoint expects an object.

urlstringRequiredformat: "uri"

Response

Webhook configuration

abandoned_event_countinteger>=0

enabledboolean

latest_eventobject or null

signing_secretstring

Use this secret to verify the webhook-signature header over {webhook-id}.{webhook-timestamp}.{raw-body} with HMAC-SHA256.

urlstringformat: "uri"

Errors

400

Bad Request Error

401

Unauthorized Error

503

Service Unavailable Error