Accounts API

List Accounts

GET /admin/accounts

Query Parameters:

Parameter	Type	Description
app_key	string	Filter by application key
provider	string	Filter by provider name

Example:

curl "https://ingest.transyt.com/admin/accounts?provider=stripe" \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN"

Response:

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "provider": "stripe",
    "account_slug": "my-app",
    "app_key": "my-app",
    "org_id": null,
    "delivery_url": "https://my-app.com/webhooks/transyt",
    "enabled": true,
    "skip_signature_verification": false
  }
]

Create Account

POST /admin/accounts

Request Body:

Field	Type	Required	Description
provider	string	Yes	Provider name (e.g., stripe, mailgun)
account_slug	string	Yes	Unique identifier within the provider (max 100 chars)
app_key	string	Yes	Application key for grouping accounts (max 50 chars)
org_id	string	No	Organization identifier (max 100 chars)
signing_secret_current	string	No	Active signing secret
signing_secret_previous	string	No	Previous secret for rotation
skip_signature_verification	boolean	No	Skip signature verification (default: false)
delivery_url	string	No	URL to deliver events to (max 500 chars)
delivery_secret	string	No	Secret for signing deliveries
project_id	string	No	Project identifier
project_delivery_url	string	No	Fallback delivery URL
project_delivery_secret	string	No	Fallback delivery secret
enabled	boolean	No	Whether the account is active (default: true)

Example:

curl -X POST https://ingest.transyt.com/admin/accounts \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "stripe",
    "account_slug": "my-app",
    "app_key": "my-app",
    "signing_secret_current": "whsec_...",
    "delivery_url": "https://my-app.com/webhooks/transyt",
    "delivery_secret": "my-secret"
  }'

Update Account

PATCH /admin/accounts/{account_id}

Accepts the same fields as create. Only included fields are updated.

Example:

curl -X PATCH https://ingest.transyt.com/admin/accounts/{account_id} \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"delivery_url": "https://new-url.com/webhooks"}'

Delete Account

DELETE /admin/accounts/{account_id}

Example:

curl -X DELETE https://ingest.transyt.com/admin/accounts/{account_id} \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN"

Test Delivery

Test that a delivery URL is reachable:

POST /admin/accounts/{account_id}/test-delivery

Example:

curl -X POST https://ingest.transyt.com/admin/accounts/{account_id}/test-delivery \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN"

Returns a success or error response indicating whether the delivery URL is accessible.