POST
/
apps
/
{app_id}
/
webhooks
curl --request POST \
  --url https://api.withcortex.ai/apps/{app_id}/webhooks \
  --header 'Content-Type: application/json' \
  --data '{
  "url": "https://example.com/webhook",
  "events": [
    "record.created",
    "record.completed"
  ]
}'
{
  "id": "<string>",
  "url": "https://example.com/webhook",
  "created_at": "2023-12-25",
  "updated_at": "2023-12-25",
  "events": [
    "record.created",
    "record.completed"
  ]
}

Path Parameters

​
app_id
string
required

The ID of the app

Body

The webhook to create.

Data to create a new webhook

​
url
string
required

URL to which the webhook will send POST requests

Example:

"https://example.com/webhook"

​
events
enum<string>[]
required

List of events that trigger the webhook

Type of the webhook event

Available options:
record.created,
record.running,
record.completed,
record.failed
Example:
["record.created", "record.completed"]

Response

200 - application/json
The created webhook.

Detailed information about a webhook

​
id
string
required

Unique identifier for the webhook

​
url
string
required

URL to which the webhook will send POST requests

Example:

"https://example.com/webhook"

​
created_at
string | null
required

Timestamp when the webhook was created

​
updated_at
string | null
required

Timestamp when the webhook was last updated

​
events
enum<string>[]
required

List of events that trigger the webhook

Type of the webhook event

Available options:
record.created,
record.running,
record.completed,
record.failed
Example:
["record.created", "record.completed"]

Was this page helpful?

Raise issue