POST
/
v1
/
webhooks
/
endpoints
curl --request POST \
  --url https://api.hyperline.co/v1/webhooks/endpoints \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "description": "Production webhook endpoint",
  "url": "https://example.com/webhook",
  "secret": "<string>",
  "rate_limit": 123,
  "event_types": [
    "customer.created",
    "customer.updated"
  ]
}'
{
  "id": "ep_1srOrx2ZWZBpBUvZwXKQmoEYga2",
  "description": "Production webhook endpoint",
  "url": "https://example.com/webhook",
  "rate_limit": 123,
  "event_types": [
    "customer.created",
    "customer.updated"
  ],
  "created_at": "2023-01-20T16:04:11Z"
}

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
description
string

Webhook endpoint description.

url
string
required

Webhook endpoint URL.

secret
string

Webhook endpoint verification secret (base64 encoded random bytes). If not defined, a secret is automatically generated and only accessible in the UI.

rate_limit
number

Webhook rate limit (per second).

event_types
enum<string>[]

Webhook event types filter. If not defined, all event messages will be sent.

Available options:
customer.created,
customer.updated,
customer.archived,
customer.recovered,
customer.deleted,
subscription.created,
subscription.trial_ended,
subscription.activated,
subscription.paused,
subscription.updated,
subscription.cancellation_scheduled,
subscription.cancelled,
subscription.voided,
subscription.errored,
subscription.charged,
subscription.commitment_renewed,
invoice.grace_period.started,
invoice.ready,
invoice.settled,
credit_note.ready,
credit_note.settled,
checkout.created,
checkout.completed,
payment_method.created,
payment_method.activated,
payment_method.errored,
payment_method.deleted,
wallet.credited,
wallet.debited,
daily_analytics.ready,
dataloader.failed,
credit.low_balance,
credit.balance_refreshed,
credit.created,
credit.updated,
credit.balance_at_zero,
credit.topup_transaction_created,
credit.usage_transaction_created,
quote.created,
quote.updated,
quote.approved,
quote.sent,
quote.signed,
quote.voided

Response

201 - application/json
id
string
required

Webhook endpoint ID.

description
string
required

Webhook endpoint description.

url
string
required

Webhook endpoint URL.

rate_limit
number | null
required

Webhook rate limit (per second).

event_types
enum<string>[] | null
required

Webhook event types filter. If not defined, all event messages will be sent.

Available options:
customer.created,
customer.updated,
customer.archived,
customer.recovered,
customer.deleted,
subscription.created,
subscription.trial_ended,
subscription.activated,
subscription.paused,
subscription.updated,
subscription.cancellation_scheduled,
subscription.cancelled,
subscription.voided,
subscription.errored,
subscription.charged,
subscription.commitment_renewed,
invoice.grace_period.started,
invoice.ready,
invoice.settled,
credit_note.ready,
credit_note.settled,
checkout.created,
checkout.completed,
payment_method.created,
payment_method.activated,
payment_method.errored,
payment_method.deleted,
wallet.credited,
wallet.debited,
daily_analytics.ready,
dataloader.failed,
credit.low_balance,
credit.balance_refreshed,
credit.created,
credit.updated,
credit.balance_at_zero,
credit.topup_transaction_created,
credit.usage_transaction_created,
quote.created,
quote.updated,
quote.approved,
quote.sent,
quote.signed,
quote.voided
created_at
string
required

Webhook creation date.

Get webhook endpointsGet webhook endpoint