USusememos
UserService

POST /api/users/{user}/webhooks

Changed on

CreateUserWebhook creates a webhook for a user. Only the user may call it. The service generates a signing secret when none is given.

Request

  • The document declares no server URL.
  • Auth
    none declared

Path parameters

userstring required

The user id.

Request body

namestring

Identifier. The resource name of the webhook. Format: users/{user}/webhooks/{webhook}

displayNamestring

A human-readable name for the webhook.

urlstring

The URL the webhook request is sent to. Required on create.

signingSecretstring

Input only. The secret used to HMAC-SHA256 sign the webhook request body. Never returned; use GetUserWebhookSigningSecret to read it.

signingSecretSetboolean

Output only. Whether a signing secret is configured for this webhook.

createTimestring date-time

Output only. The creation timestamp. Currently never set.

updateTimestring date-time

Output only. The last update timestamp. Currently never set.

Response

OK

namestring

Identifier. The resource name of the webhook. Format: users/{user}/webhooks/{webhook}

displayNamestring

A human-readable name for the webhook.

urlstring

The URL the webhook request is sent to. Required on create.

signingSecretstring

Input only. The secret used to HMAC-SHA256 sign the webhook request body. Never returned; use GetUserWebhookSigningSecret to read it.

signingSecretSetboolean

Output only. Whether a signing secret is configured for this webhook.

createTimestring date-time

Output only. The creation timestamp. Currently never set.

updateTimestring date-time

Output only. The last update timestamp. Currently never set.

Changes