Create Webhook

Operation ID: webhooks.create

POST

https://api.authpi.com/v1/accounts/{account_id}/webhooks

Create a new webhook in an account.

Request body

Schema | application/json

name

required string

url

required string[uri]

bearer_token

string

uses_signature

If the webhook should use a signature. If true, the signature_secret can be set for HMAC signatures.

required boolean

events

array[string]

signature_secret

For HMAC signatures. If not set but uses_signature is true, a secret will be generated and returned.

string

201

Webhook created

400

Bad request - The request is not valid or missing required parameters.

401

Unauthorized - The request is not allowed because the client or user is not authenticated.

403

Forbidden - The request is not allowed because the client or user does not have the necessary permissions.

404

Not found - The requested resource does not exist.

422

Unprocessable entity - The data provided in the request is not valid.

429

Too many requests - The client has sent too many requests in a given amount of time.

500

Internal server error - An unexpected error occurred while processing the request.