Skip to content
Fromenance docsFromenance docs

Create an endpoint

POST
/v1/webhook-endpoints
curl --request POST \
  --url https://api.fromenance.com/v1/webhook-endpoints \
  --header 'Content-Type: application/json' \
  --cookie fromenance.session_token=<fromenance.session_token> \
  --data '{ "url": "https://example.com", "events": [ "verdict.created" ], "description": "example" }'

Deliveries are signed with HMAC-SHA256 over timestamp.body using the returned secret (shown once), sent as X-Fromenance-Signature: v1= with X-Fromenance-Timestamp. Retried with backoff for 24 hours.

Authorizations

Section titled “Authorizations”

Request Body

Section titled “Request Body”
Media typeapplication/json
object
url
required
string format: uri
<= 500 characters
events
Array<string>
>= 1 items
Allowed values: verdict.created submission.replay_detected indicator.new campaign.detected
description
string
<= 200 characters

Responses

Section titled “ Responses ”

201

Section titled “201”

Endpoint with secret

Media typeapplication/json
object
id
required
string
url
required
string
events
required
Array<string>
status
required
string
description
required
string | null
last_delivery_at
required
string | null
last_status
required
integer | null
created_at
required
string
secret
required
string
Examplegenerated
{
  "id": "example",
  "url": "example",
  "events": [
    "example"
  ],
  "status": "example",
  "description": "example",
  "last_delivery_at": "example",
  "last_status": 1,
  "created_at": "example",
  "secret": "example"
}