Generate an ordway webhook secret

POST/connections/ordway/{conn_id}/webhook-secret/generate

Generate (or return the existing) Ordway L2 webhook secret and full webhook URL for registration in Ordway Setup -> Webhooks. Pass regenerate=true to rotate an existing secret; the previous secret stops verifying once rotated. Served only from this route: the secret is never returned again on a read. Returns 403 if your credential is not permitted to enable Ordway L2 (a staff-only beta). Returns 404 if the connection does not exist, is not an Ordway connection, or belongs to an organization your credential cannot access. A multi-org credential must send an Organization-Id, Connection-Id or Entity-Id selector, or gets a 400.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Target organization id (Organization-Id selector).

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Path parameters

conn_idstringRequired

The unique identifier of the connection.

Query

Every query parameter below is optional. Combine as many as you need and append them to the endpoint as a query string. The example shows a few to get you started.

/connections/ordway/{conn_id}/webhook-secret/generate?regenerate=<regenerate>

regenerateboolean

Response

webhookUrlstringRequired

Full webhook URL to register in Ordway.

webhookSecretstringRequired

Ordway L2 webhook secret.

200

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

422

The request failed validation.

cURL

POST /connections/ordway/{conn_id}/webhook-secret/generate?regenerate=false

-H "Api-Key: ***"

-H "Api-Version: 2026-07-21"

Example request

https://api.trykintsugi.com/connections/ordway/{conn_id}/webhook-secret/generate?regenerate=false

Response

{

"webhookUrl": "https://www.example.com",

"webhookSecret": "********"

}