Skip to content
ParaSta Docs

Create a Webhook Endpoint

POST
/v1/webhook_endpoints
 
curl --request POST \
  --url https://api.parasta.io/v1/webhook_endpoints \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "url": "https://your-site.com/webhook", "enabled_events": [ "checkout.session.completed", "payment.failed", "refund.succeeded" ] }'

Returns the signing secret in the response — store it. The secret is not retrievable later.

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
Media type application/json
object
url
required
string format: uri
enabled_events
required
Array<string>
Example 
{
  "url": "https://your-site.com/webhook",
  "enabled_events": [
    "checkout.session.completed",
    "payment.failed",
    "refund.succeeded"
  ]
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Created

Media type application/json
object
id
required
string
url
required
string format: uri
enabled_events
required
Array<string>
Allowed values: payment.created payment.pending payment.succeeded payment.failed payment.expired checkout.session.completed checkout.session.expired qr.session.completed refund.created refund.succeeded refund.failed
secret_preview
required

First 8 chars of the signing secret. Full secret only shown on POST.

string
status
required
string
Allowed values: enabled disabled
created
string format: date-time
secret

The full signing secret. Store this — it cannot be retrieved later.

string
Example 
{
  "id": "we_abc123",
  "enabled_events": [
    "payment.created"
  ],
  "status": "enabled"
}