Skip to content
Pitch2SaleDevelopers
Open the app
Early access: these pages are being written and reviewed. Facts in the header boxes come straight from the product.

Send a test event to a webhook

POST
/api/v1/webhooks/test/{id}
curl --request POST \
--url https://api.pitch2sale.com/api/v1/webhooks/test/example \
--header 'Authorization: Bearer <token>'

Synchronously POSTs a signed webhook.test event (10 s timeout, redirects not followed) and reports the outcome; nothing is recorded as a delivery.

id
required
string

The test outcome

Media typeapplication/json
object
success
required
boolean
status_code
required
number | null
error
required
string | null
Examplegenerated
{
"success": true,
"status_code": 1,
"error": "example"
}

Authentication required or token invalid

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}

Role permission or token scope missing

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}

Rate limit exceeded

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}