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": "2024-01-20T16:04:11Z"
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
url
string
required

Webhook endpoint URL.

Example:

"https://example.com/webhook"

​
description
string

Webhook endpoint description.

Example:

"Production webhook endpoint"

​
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:
event.price_calculated,
customer.created,
customer.updated,
customer.archived,
customer.recovered,
customer.deleted,
subscription.created,
subscription.trial_ended,
subscription.activated,
subscription.reactivated,
subscription.contract_started,
subscription.paused,
subscription.phase_activated,
subscription.updated,
subscription.cancellation_scheduled,
subscription.cancelled,
subscription.voided,
subscription.errored,
subscription.charged,
subscription.commitment_renewed,
subscription.reinstated,
invoice.created,
invoice.grace_period.started,
invoice.ready,
invoice.settled,
invoice.errored,
invoice.voided,
invoice.reminder_sent,
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.approval_requested,
quote.approved,
quote.sent,
quote.viewed,
quote.signed,
quote.voided,
bank_account.created,
bank_account.deleted,
custom_property.created,
custom_property.updated,
custom_property.deleted,
custom_property.value_created,
custom_property.value_updated,
product.created,
product.archived,
product.recovered,
product.deleted
Example:
["customer.created", "customer.updated"]

Response

201 - application/json
​
id
string
required

Webhook endpoint ID.

Example:

"ep_1srOrx2ZWZBpBUvZwXKQmoEYga2"

​
description
string
required

Webhook endpoint description.

Example:

"Production webhook endpoint"

​
url
string
required

Webhook endpoint URL.

Example:

"https://example.com/webhook"

​
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:
event.price_calculated,
customer.created,
customer.updated,
customer.archived,
customer.recovered,
customer.deleted,
subscription.created,
subscription.trial_ended,
subscription.activated,
subscription.reactivated,
subscription.contract_started,
subscription.paused,
subscription.phase_activated,
subscription.updated,
subscription.cancellation_scheduled,
subscription.cancelled,
subscription.voided,
subscription.errored,
subscription.charged,
subscription.commitment_renewed,
subscription.reinstated,
invoice.created,
invoice.grace_period.started,
invoice.ready,
invoice.settled,
invoice.errored,
invoice.voided,
invoice.reminder_sent,
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.approval_requested,
quote.approved,
quote.sent,
quote.viewed,
quote.signed,
quote.voided,
bank_account.created,
bank_account.deleted,
custom_property.created,
custom_property.updated,
custom_property.deleted,
custom_property.value_created,
custom_property.value_updated,
product.created,
product.archived,
product.recovered,
product.deleted
Example:
["customer.created", "customer.updated"]
​
created_at
string
required

Webhook creation date.

Example:

"2024-01-20T16:04:11Z"