Webhooks V2

List the uploaded mTLS configurations

Lists the workspace's mTLS configurations, newest first. Pass ids to ask about particular ones instead — useful for resolving the webhookMtlsId values on a set of webhooks in one call.

get/webhooks_settings/mtls

Request

Query parameters

idsstring[]

Return only the configurations with these ids, instead of all of them. Repeat the parameter for each id. An id belonging to another workspace, or to nothing, is left out of the response rather than failing the request.

Response

The workspace's mTLS configurations

idstring uuid required

The unique identifier of the mTLS configuration, to be set as webhookMtlsId on a webhook or on OAuth credentials.

namestring

The label given to this mTLS configuration.

signedCertstring required

The signed client certificate PEM.

expiresAtinteger required

When the certificate itself expires, in milliseconds since the epoch.

createdAtinteger required

When the certificate was uploaded, in milliseconds since the epoch.

updatedAtinteger required

When this configuration was last changed, in milliseconds since the epoch. Differs from createdAt once the certificate has been replaced or the configuration renamed.

Example response

[
  {
    "id": "44fcead0-7053-4831-a53a-df7fb90d440f",
    "name": "Production gateway 2026",
    "signedCert": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
    "expiresAt": 1726108200000,
    "createdAt": 1694572200000,
    "updatedAt": 1726108200000
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.