Skip to main content
POST
Create a webhook

Authorizations

x-fngs-public-key
string
header
required
x-fngs-secret-key
string
header
required

Body

application/json

POST /v0/webhooks/create Request body

url
string<url>
required

HTTP(S) endpoint that receives event deliveries. Must use http:// or https:// and must not resolve to a loopback, private, or link-local address.

status
enum<string>
required

Whether the webhook receives deliveries: - active: Receives deliveries for its subscribed events - inactive: Configured but not currently receiving deliveries

Available options:
active,
inactive
secret
string
required

Caller-supplied signing secret used to verify the 'x-fngs-signature' header on each delivery. Any string of at least 16 characters — no required prefix or format.

Minimum string length: 16
events
enum<string>[]

Event types this webhook is subscribed to. Omit to subscribe to no events.

Available options:
payment_success,
payment_refunded,
payment_failed,
subscription_created,
subscription_interval,
subscription_updated,
subscription_cancelled

Response

POST /v0/webhooks/create Positive response

status
string
required
Allowed value: "success"
data
object
required