Register a new webhook

POST 
/webhook

Register a new webhook

Request

application/json

Body

Webhook registration data

body string

The body for the webhook request, supporting variables.

resourceId stringrequired

Identifier of the resource to attach webhook to

url urirequired

The URL to which the webhook will send event data.

eventType stringrequired

Possible values: [submission_approved]

Event type that triggers the webhook.

headers string

Custom headers to include in the webhook request, such as authentication tokens.

resource stringrequired

Possible values: [schema]

Resource to attach the webhook to

Responses

201

Webhook successfully created

application/json

Schema

Schema

body string

The body for the webhook request, supporting variables.

resourceId stringrequired

Identifier of the resource to attach webhook to

createdAt date-time

Time representation of entity creation

projectId string

Unique identifier of the project to which webhook is related

url urirequired

The URL to which the webhook will send event data.

eventType stringrequired

Possible values: [submission_approved]

Event type that triggers the webhook.

headers string

Custom headers to include in the webhook request, such as authentication tokens.

id string

Unique identifier of the webhook

resource stringrequired

Possible values: [schema]

Resource to attach the webhook to

Example (from schema)

{
  "body": "{\"userId\": \"$userId\", \"resource\": \"$resource\", \"resourceId\": \"$resourceId\"}",
  "resourceId": "s12RHo2ET",
  "createdAt": "2024-01-01T09:00:00.00Z",
  "projectId": "p2Duhf5N6",
  "url": "https://example.com/webhook/$userId",
  "eventType": "submission_approved",
  "headers": "{\"Bearer\": \"$bearertoken\", \"customHeader\": \"$customHeader\"}",
  "id": "a1fb86bad-de7c-4ed7-a1c6-538db2b0c9ed",
  "resource": "schema"
}

400

Bad Request

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

Example

{
  "error": "Bad Request"
}

401

Unauthorized

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

Example

{
  "error": "Unauthorized access"
}

403

Forbidden

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

Example

{
  "error": "Forbidden access"
}

404

NotFound

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

Example

{
  "error": "A mandatory item was not found"
}

500

Internal Server Error

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

Example

{
  "error": "Internal Server Error"
}

default

Unexpected error

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

Example

{
  "error": "An unexpected error occured"
}

Loading...